Operator INPUT REST API umożliwia wywołanie dowolnego serwisu dostępnego w standardzie REST, odebranie zwróconych przez niego danych oraz wprowadzenie ich na magistralę w formie tekstowej lub bitowej. Aby dowiedzieć się więcej o konwersji danych tekstowych na bity magistrali danych zapoznaj się z operatorem CONVERT FORMAT TO BITS.

Operator INPUT REST API wykonywany jest jednorazowo na początku magistrali i inicjuje jej działanie, pobierając dane niezależnie od wcześniejszych rekordów.

Konfiguracja operatora pozwala na:

• wskazanie adresu serwisu REST oraz metody HTTP (GET, POST itd.),
• dynamiczne ustawienie nagłówków i parametrów zapytania,
• obsługę różnych mechanizmów autoryzacji,
• oraz kontrolę nad formatem odbieranych danych.

Dzięki temu operatorowi możliwe jest automatyczne załadowanie danych z systemów zewnętrznych do środowiska GRAVITY i rozpoczęcie dalszego przetwarzania w projekcie.

PRZYKŁAD PROCESU Z UŻYCIEM OPERATORA

Proces zakłada samodzielne sprawdzenie Status Code zwracanego przez wywołany serwis.

KONFIGURACJA MAGISTRALI WYJŚCIOWEJ

<aside> <img src="/icons/info-alternate_green.svg" alt="/icons/info-alternate_green.svg" width="40px" /> W przypadku użycia operatora INPUT REST API, magistrala wyjściowa operatora będzie zawierać jeden rekord zbudowany z pola danych odebranych z serwisu (zwykle format JSON, ale może to być również format XML lub czysty tekst) oraz - w zależności od konfiguracji - pola Error checking ze zwróconym Status Code wykonania serwisu.

</aside>

Na zakładce Execution należy ustawić sposób działania operatora po otrzymaniu odpowiedzi od wywołanej usługi.

• New column with result → Nazwa kolumny (bitu) magistrali danych wyjściowej gdzie zostaną przekierowane dane odebrane z usługi sieciowej (web service).
• Error checking → określa sposób zachowania operatora po odebraniu Status Code oznaczającego błędne wykonanie serwisu.
  • Report an error when Status Code is invalid → w przypadku błędnego Status Code proces zostaje zatrzymany i jako błąd zostanie wyświetlony komunikat z pola Body field with an error message.
  • Send Status Code on the busbar → w tym wypadku proces nie zostanie zatrzymany, a Status Code zostanie przekazany na magistralę danych w bicie o nazwie podanym w polu New column with Status Code i może zostać zweryfikowany w procesie przy użyciu operatora IF. Jeśli usługa zwraca szczegóły błędu są one dostępne w polu New column with result
• Body field with an error message → komunikat błędu w przypadku przerwania działania procesu automatycznie gdy otrzymany jest niepoprawny Status Code.