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ł Mieteo, 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ład komunikaty do aplikacji zewnętrznej oraz mógł z niej pobierad dane.
Rysunek 1. BizAgi Studio - wejście w tryb definiowania interfejsu integracji
Aby przejśd do narzędzia za pomocą, którego będziemy mogli zdefiniowad 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 pobrad ilośd punktów ECTS. W tym celu klikamy na daną aktywnośd.
Rysunek 2. 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ład metodę zdalną. Podajemy adres WebSerwisu
aplikacji, którą stworzyliśmy w poprzedniej części. Należy pamiętad aby usługa była uruchomiona, w
tym celu w Visual Studio należy wcisnąd Carl+F5. Po wciśnięciu przycisku GO pokaże się lista
dostępnych metod. Wybieramy metodę PobierzPunktyEcts i przechodzimy dalej.
Rysunek 3. Definiowanie interfejsu - krok 2
W drugim kroku wskazujemy, które dane z workflow mają zostad 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 4. Definiowanie interfejsu - krok 3
W kolejnym kroku możemy stworzyd przypisanie dla wartości zwracanej przez wywoływaną metodę.
Jej wynikiem jest liczba punktów ECTS, więc łączymy z polem PunktyECTS.
Rysunek 5. Definiowanie interfejsu - krok 4
W ostatnim kroku możemy zdefiniowad akcję w przypadku błędów wywołanie, oraz zdefiniowad
warunki, przy których błąd ma się wygenerowad. Zostawiamy ustawienia domyślne i kooczymy
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 uruchomid 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śd do obszaru definicji zdarzeo.
Rysunek 6. 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
zmieniad obszary pracy w BizAgi Studio. Przejdz
my do  Activity Action . Następnie na zdarzeniu
 Wpłynięcie pieniędzy na akcji wejścia dodajmy nowe Expression.
Rysunek 7. 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 8. Nadanie nazwy usłudze sieciowej
Narzędzie poprosi nas o podanie nazwy dla dodawanego elementu.
Rysunek 9. Usługa sieciowa bez zdefiniowanych parametrów
Na dodanym elemencie klikamy dwukrotnie, aby uruchomid kreator konfiguracji.
Rysunek 10. Kreator konfiguracji wywołania usługi sieciowej - Krok 1
W pierwszym kroku musimy podad adres usługi sieciowej.
Rysunek 11. Kreator konfiguracji wywołania usługi sieciowej - Krok 2
Z listy dostępnych metod wybieramy DodajNowaOplate i przechodzimy dalej.
Rysunek 12. Kreator konfiguracji wywołania usługi sieciowej - Krok 3
W kolejnym kroku musimy zdefiniowad przypisania dla parametrów wejściowych. Zaznaczamy
pierwszy z nich i wciskamy  Set Value& 
Rysunek 13. Kreator konfiguracji wywołania usługi sieciowej - Krok 3 - Przypisanie identyfikatora aktualnego kroku
procesu
Aby przypisad identyfikator aktualnego kroku musimy wpisad wyrażenie Me.Case.Id.
Rysunek 14. 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
.
Rysunek 15. Kreator konfiguracji wywołania usługi sieciowej - Krok 3 - Skonfigurowane parametry wejściowe
Po zdefiniowani wszystkich parametrów wejściowych przechodzimy dalej.
Rysunek 16. Kreator konfiguracji wywołania usługi sieciowej - Krok 4
Metoda ta nie zwraca żadnej wartości, więc pozostawiając domyślne ustawienia zakooczymy
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 dodad
taką encję należy przejśd w widok modułowy narzędzia.
Rysunek 17. Przejście w tryb modułowy
W prawym górnym rogu aplikacji wybieramy opcję Modules.
Rysunek 18. 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ęz
le systems wybieramy opcję  New System&  .
Rysunek 19. Dodawanie nowego systemu
W oknie konfiguracyjnym ustawiamy nazwę  TutorialSystem oraz wybieramy opcję  Enable Virtual
Entities and Replication for this System .
Następnie na węz
le Systems->Tutorial System->Providers z menu kontekstowego wybieramy opcję
 New Provider& 
Rysunek 20. 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 21. Konfiguracja połączenia do bazy danych
Konfigurujemy połączenie do bazy danych.
Rysunek 22. Utworzenie encji wirtualnej
Na węz
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 zakooczeniu
wciskamy przycisk OK.