Projektowanie systemu workflow przy użyciu narzędzia BizAgi Studio

Część 6
Integracja z systemem zewnętrznym

Instytut Systemów Informatycznych, Wydział Cybernetyki, Wojskowa Akademia Techniczna

Paweł Mieteń, Jarosław Koszela

Integracja z systemem zewnętrznym

Po utworzeniu systemu zewnętrznego przystąpimy do skonfigurowania projektu w BizAgi Studio, tak aby workflow mógł wysyłać komunikaty do aplikacji zewnętrznej oraz mógł z niej pobierać dane.

Rysunek . BizAgi Studio - wejście w tryb definiowania interfejsu integracji

Aby przejść do narzędzia za pomocą, którego będziemy mogli zdefiniować integracje z systemami zewnętrznymi klikamy na opcję „Define Integration Interfaces”.

Na aktywności „Pobieranie informacji o studencie” dodamy odwołanie do naszego serwisu zewnętrznego, tak aby pobrać ilość punktów ECTS. W tym celu klikamy na daną aktywność.

Rysunek . Definiowanie interfejsu - krok 1

BizAgi Studio otworzy kreator za pomocą, którego skonfigurujemy interfejs. W polu URL podajemy adres usługi sieciowej, z której chcemy wywołać metodę zdalną. Podajemy adres WebSerwisu aplikacji, którą stworzyliśmy w poprzedniej części. Należy pamiętać aby usługa była uruchomiona, w tym celu w Visual Studio należy wcisnąć Carl+F5. Po wciśnięciu przycisku GO pokaże się lista dostępnych metod. Wybieramy metodę PobierzPunktyEcts i przechodzimy dalej.

Rysunek . Definiowanie interfejsu - krok 2

W drugim kroku wskazujemy, które dane z workflow mają zostać załadowane, jako parametry wejściowe do metody. Robimy to metodą drag and drop. W naszym przypadku łapiemy za trójkącik przy numerze indeksu i przeciągamy na parametr wejściowy wywoływanej metody.

Rysunek . Definiowanie interfejsu - krok 3

W kolejnym kroku możemy stworzyć przypisanie dla wartości zwracanej przez wywoływaną metodę. Jej wynikiem jest liczba punktów ECTS, więc łączymy z polem PunktyECTS.

Rysunek . Definiowanie interfejsu - krok 4

W ostatnim kroku możemy zdefiniować akcję w przypadku błędów wywołanie, oraz zdefiniować warunki, przy których błąd ma się wygenerować. Zostawiamy ustawienia domyślne i kończymy proces definiowania interfejsu.

Drugą interakcję z systemem zewnętrznym będzie dodanie do systemu zewnętrznego nowej opłaty, tak aby użytkownik systemu zewnętrznego mógł zdalnie uruchomić zdarzenie pośrednie „Wpłynięcie pieniędzy”. Nie jest możliwe dodanie odwołania do usługi sieciowej na elemencie zdarzenia pośredniego w sekcji definiowania interfejsów. Należy przejść do obszaru definicji zdarzeń.

Rysunek . Skrót do zmiany obszaru pracy

W prawym górnym rogu okna znajduje się lista rozwijana, załomocą której możemy w szybki sposób zmieniać obszary pracy w BizAgi Studio. Przejdźmy do „Activity Action”. Następnie na zdarzeniu „Wpłynięcie pieniędzy” na akcji wejścia dodajmy nowe Expression.

Rysunek . Dodanie odwołania do usługi sieciowej w Expression

Na strzałce łączącej początek i koniec wyrażenia używając menu kontekstowego wybieramy opcję „Add Web Service”.

Rysunek . Nadanie nazwy usłudze sieciowej

Narzędzie poprosi nas o podanie nazwy dla dodawanego elementu.

Rysunek . Usługa sieciowa bez zdefiniowanych parametrów

Na dodanym elemencie klikamy dwukrotnie, aby uruchomić kreator konfiguracji.

Rysunek . Kreator konfiguracji wywołania usługi sieciowej - Krok 1

W pierwszym kroku musimy podać adres usługi sieciowej.

Rysunek . Kreator konfiguracji wywołania usługi sieciowej - Krok 2

Z listy dostępnych metod wybieramy DodajNowaOplate i przechodzimy dalej.

Rysunek . Kreator konfiguracji wywołania usługi sieciowej - Krok 3

W kolejnym kroku musimy zdefiniować przypisania dla parametrów wejściowych. Zaznaczamy pierwszy z nich i wciskamy „Set Value…”

Rysunek . Kreator konfiguracji wywołania usługi sieciowej - Krok 3 - Przypisanie identyfikatora aktualnego kroku procesu

Aby przypisać identyfikator aktualnego kroku musimy wpisać wyrażenie Me.Case.Id.

Rysunek . Kreator konfiguracji wywołania usługi sieciowej - Krok 3 - Przypisanie numeru indeksu

Do drugiego parametru przypisujemy numer indeksu z encji wniosek, w tym celu używamy wyrażenia <Wniosek.NumerIndeksu>.

Rysunek . Kreator konfiguracji wywołania usługi sieciowej - Krok 3 - Skonfigurowane parametry wejściowe

Po zdefiniowani wszystkich parametrów wejściowych przechodzimy dalej.

Rysunek . Kreator konfiguracji wywołania usługi sieciowej - Krok 4

Metoda ta nie zwraca żadnej wartości, więc pozostawiając domyślne ustawienia zakończymy konfigurację.

Ostatnim mechanizmem integracyjnym, który zostanie przedstawiony w tym dokumencie są encje wirtualne. Jest to sposób „dopięcia” do BizAgi Studio tabeli z zewnętrznej bazy danych. Aby dodać taką encję należy przejść w widok modułowy narzędzia.

Rysunek . Przejście w tryb modułowy

W prawym górnym rogu aplikacji wybieramy opcję Modules.

Rysunek . Widok modułowy

Z lewej strony znajduje się lista modułów, z której wybieramy opcję Systems. Następnie używając meny kontekstowego na węźle systems wybieramy opcję „New System…”.

Rysunek . Dodawanie nowego systemu

W oknie konfiguracyjnym ustawiamy nazwę „TutorialSystem” oraz wybieramy opcję „Enable Virtual Entities and Replication for this System”.

Następnie na węźle Systems->Tutorial System->Providers z menu kontekstowego wybieramy opcję „New Provider…”

Rysunek . Konfiguracja Providera

Na wyświetlonej formatce nazywamy Providera ExternalDB oraz wybieramy opcję „Enable Virtual Entities for this Provider”. Następnie przechodzimy na druga zakładkę ”Provider Development Properties” i wciskamy przycisk „OLEDB config”.

Rysunek . Konfiguracja połączenia do bazy danych

Konfigurujemy połączenie do bazy danych.

Rysunek . Utworzenie encji wirtualnej

Na węźle Systems->Providers->ExternalDB->Virtual Entities->Default Virtual Entity z menu kontekstowego wybieramy opcję “Add Entity to Virtual”. Na wyświetlonym oknie wybieramy Encję Przedmioty oraz do „External Source” wpisujemy nazwę tabeli, a więc Przedmioty. Po zakończeniu wciskamy przycisk OK.