Startowanie obiegu z zewnętrznego systemu – REST API

Facebooktwitterpinterestlinkedinmail
Dotyczy wersji: 2020.1.x i wyższych; autor: Tomasz Słuszniak

 

Jednym ze sposobów wystartowania obiegu w WEBCON BPS może być wykorzystanie REST API BPS. Może on być szczególnie przydatny w takich sytuacjach jak:

  • Wymiana danych między różnymi instancjami BPS – np. instancja działająca wyłącznie wewnątrz organizacji oraz instancja publiczna, dostępna np. dla naszych klientów
  • Wymiana danych z systemami firm trzecich np. CRM, ERP

Przykład wykorzystania – startowanie obiegu za pomocą REST API w procesie projektowym.

Pierwszym krokiem będzie utworzenie aplikacji, która umożliwi dostęp do API – w WEBCON BPS Portal należy wejść w zakładkę „Administracja”, a następnie z zakładki „Integracje” wybrać API i utworzyć nową aplikację za pomocą przycisku „Nowa aplikacja”.

 

 

Na ekranie pojawi się okno, w którym należy uzupełnić dane aplikacji. W przypadku uruchamiania obiegu przez REST API, jako autor będzie widoczny użytkownik którego dane uzupełniane są w polach Nazwa, Login oraz E-mail. Login musi być wpisany w formacie UPN i nie może się powtarzać (w AD nie może być użytkownika o takim samym loginie).

Impersonacja – opcja umożliwia wykonanie operacji przez REST API w imieniu innego użytkownika. Można także określić w jakich aplikacjach Impersonacja będzie możliwa.

 

Po zapisaniu aplikacji kolejnym krokiem będzie utworzenie prywatnego klucza wykorzystywanego podczas wywołania REST API – kliknij przycisk „Generuj nowy sekret”.

 

Tak wygenerowany klucz należy zapisać, ponieważ jego ponowne wyświetlenie nie będzie możliwe.

 

Aby mieć możliwość wykonywania operacji przez REST API należy się zalogować – w tym celu użyj danych zapisanych podczas tworzenie aplikacji API. Potrzebne będą dane ClientID oraz ClientSecret (prywatny klucz). Podczas uruchamiania obiegu będzie wykorzystywana także opcja impersonacji, aby użyć kontekstu pracownika i np. uniemożliwić wykonanie operacji, do których użytkownik nie ma uprawnień (np. brak możliwości startowania lub edytowania elementu obiegu).

Aby się zalogować, należy wysłać żądanie metodą POST na adres:

http://adres_portalu_webcon_bps/api/login

 

W odpowiedzi otrzymamy token, który umożliwi nam wykonywanie kolejnych operacji przez REST API.

Token należy przekazywać jako nagłówek w kolejnych żądaniach.

Aby wystartować obieg należy wysłać żądanie POST na adres:

http://adres_portalu_webcon_bps/api/data/v2.0/db/1/elements?path=<GUID_ścieżki_przejścia>

 

GUID ścieżki lub innych obiektów BPS można uzyskać z BPS Designer Studio klikając na przycisk obok ID danego obiektu:

 

Przykładowy adres żądania:

http://wdr04/api/data/v2.0/db/1/elements?path=89083a10-b8f4-44f8-b500-df2cb417aa98

W BODY żądania należy przekazać parametry startowanego obiegu:

 

Wszystkie potrzebne GUID’y obiektów znajdziemy w BPS Designer Studio jak na przykładzie.

W odpowiedzi takiego żądania otrzymamy ID, Sygnaturę oraz Status:

 

Obieg został poprawnie wystartowany, a wynik operacji można zweryfikować na formularzu w BPS Portal:

Wywołanie REST API uruchomiło również akcję „Uruchom podobieg (SQL)”, która została skonfigurowana w pierwszym przykładzie.

Szczegółowy opis REST API oraz WEBCON BPS SDK dostępny jest pod adresem: https://developer.webcon.com/resources/

Dodaj komentarz

Twój adres email nie zostanie opublikowany. Pola, których wypełnienie jest wymagane, są oznaczone symbolem *