Operator INPUT DATA służy do wprowadzenia danych z zewnętrznych systemów do projektu GRAVITY w momencie jego uruchomienia jako usługa WebService, 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 znajduje się 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, analizując sekcję parameters w body wywołania REST API, wyszukuje w systemie parametr o nazwie zgodnej z właściwościami obiektu parameters. Jeśli taki parametr istnieje, trigger przekazuje do niego wartość danej właściwości. W przypadku INPUT DATA zazwyczaj jest to obiekt, który operator konwertuje na bity magistrali.