Operator INPUT REST API służy do wywołania dowolnego serwisu (dostępnego w standardzie REST) odebrania danych zwracanych przez serwis i wprowadzenia danych na magistralę w formie tekstowej lub bitowej (aby dowiedzieć się więcej o konwersji danych tekstowych do bitów magistrali danych zapoznaj się z operatorem CONVERT FORMAT TO BITS ).

Operator INPUT REST API umożliwia pobieranie danych z dowolnego zewnętrznego serwisu działającego w standardzie REST i wprowadzenie ich do magistrali GRAVITY jako dane wejściowe dla dalszego przetwarzania.

Operator wykonywany jest jednorazowo na początku magistrali i inicjuje jej działanie, pobierając dane niezależnie od wcześniejszych rekordów. Otrzymana odpowiedź może być zapisana bezpośrednio do bitów magistrali jako tekst, który może zostać później przekształcony do struktury rekordów i bitów przy użyciu operatora CONVERT FORMAT TO BITS.

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 StatusCode 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 czy czysty tekst) oraz w zależności od konfiguracji pola ze zwróconym StatusCode 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 → sposób zachowania operatora po odebraniu StatusCode oznaczającego błędne wykonanie serwisu.
  • Report an error when Status Code is invalid → w przypadku błędnego StatusCode 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 StatusCode 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 dostepne w polu New column with result