Realizacja wywołania poprzez zewnętrzną aplikację przy wykorzystaniu REST API odbywa się w następujących krokach:
- Uruchom aplikację Gravity.exe
- Utwórz projekt (opcja PROJECTS)
- Dodaj wyzwalacz typu webService (opcja TRIGGERS) zwróć uwagę na pole Alias. Pole to jest wykorzystywane w budowie endpoint, który będzie służył do wywołania budowanego API
- Sprawdź ustawienia adresu serwera (opcja menu OPTIONS) oraz uprawnień do wywoływania usług. Pamiętaj, że łączenie z serwerem za pośrednictwem https wymaga certyfikatu podłączonego do portu. W celach deweloperskich użyj połączenia http np. http://localhost:9010/GravityApi
- Uruchom aplikację serwera GravityTriggersRunner.exe lub zrestartuj usługę gravity.integration
- Wywołanie triggera jako REST API poprzez zewnętrzną aplikację (np. Postman)
W kontekście wywołania funkcji WEB SERVICE prawdopodobnie pojawiło się u Ciebie pytanie: w jaki sposób oprogramowanie zewnętrzne może komunikować się z procesem GRAVITY?
Koniecznie przeczytaj szczegółowy opis konfiguracji oraz komunikacji z serwerem gravity.integration:
Konfiguracja i sposoby wywołania REST APIWywołanie i odpowiedź REST API
oraz opis operatorów:
INPUT DATA oraz OUTPUT DATA (rozdział RODZAJE I OPIS OPERATORÓW GRAVITY). Te operatory są odpowiedzialne za transfer danych wejściowych oraz danych rezultatu
Jeżeli masz skonfigurowaną akcję TRIGGER typu WEBSERVICE musisz jeszcze skonfigurować serwer WEB SERVICE (opcja OPTIONS). Poprzez ten serwer będą dostępne dla oprogramowania zewnętrznego wszystkie akcje TRIGGERS typu WEBSERVICE. Identyfikacja akcji następuje na podstawie unikalnej nazwy ALIAS. Wywołanie każdej akcji skutkuje uruchomieniem aplikacji (procesu) GRAVITY skojarzonej z akcją.