Operator INPUT DATA służy do wprowadzenia danych z zewnętrznych systemów do projektu GRAVITY w momencie jego uruchomienia jako **usługa Web Service,** lub database notification.

Współpracuje on z triggerami wywołującymi aplikację, takimi jak:

• WebService (REST API) – gdy aplikacja GRAVITY jest wywoływana jako usługa HTTP,
• Database – gdy uruchomienie następuje z poziomu bazy danych PostgreSQL.

Gdy dane zostaną przesłane w formacie JSON, operator INPUT DATA:

• odbiera dane wejściowe,
• konwertuje je do postaci rekordów magistrali danych (w strukturze kolumnowo-wierszowej),
• przekazuje dane dalej do przetwarzania w projekcie GRAVITY.

Operator INPUT DATA stanowi zatem punkt wejściowy dla danych przychodzących z zewnątrz i odgrywa kluczową rolę w integracji aplikacji GRAVITY z innymi systemami. W parze z nim wykorzystywany jest zwykle operator OUTPUT DATA , który odpowiada za zwrócenie przetworzonych danych na zewnątrz.

Przykład projektu GRAVITY z użyciem operatora INPUT DATA.

Przetwarzanie dla triggera typu WebService

Trigger przyjmując dane (w formacie JSON) przetwarza je i jeśli w obiekcie parameters jest obiekt odpowiadający nazwie Parameters name na operatorze przekazuje dane tego obiektu do operatora.

Przykład

Załóżmy, że WebService został wywołany z body:

{
    "call_alias": "postArticle",
    "process_id": "-1",
    "get_data": [
        {
            "description": "OutputData1",
        }        
    ],
    "parameters": {
        "InputData1": 
        { 
            "index" : "FC985GFR55", 
            "index_name" : "Very important new article" , 
            "code" : "3434343434334343", 
            "unit" : "t"
        }
    }
}

Obiekt zawiera obiekt parameters. W wywołaniu REST API sekcja parameters służy do przekazania parametrów do uruchamianego projektu. Obiekt INPUT DATA jest traktowany jako specyficzny rodzaj parametru procesu, dostępny tylko dla triggera wywołującego projekt o nazwie nadanej w polu Parameter name na właściwościach operatora.

Trigger interpretując sekcję parameters w body wywołania REST API szuka parametru w systemie o nazwie odpowiadającej poszczególnym właściwościom obiektu parameters w body i jeśli znajdzie taki parametr przekazuje wartość właściwości do tego parametru. Dla INPUT DATA zwykle jest to obiekt, który operator konwertuje do bitów magistrali.