Uruchomienie automatyzacji

Na zakładce Automatyzacja definiowana jest sekwencja akcji wykonywana po wywołaniu endpointu skonfigurowanego w trybie Wywołaj automatyzację. Zdefiniowana tu automatyzacja będzie uruchomiana zawsze bez kontekstu elementu, zatem wszystkie akcje wykonywane w ramach automatyzacji lub inne podautomatyzacje, nie mogą odwoływać się do wartości konkretnego elementu obiegu.
W automatyzacji można natomiast zarejestrować nowy element przy pomocy akcji Uruchom obieg lub Uruchom obieg (SQL), zaktualizować element po wskazaniu jego ID w akcji Aktualizuj zależny element obiegu, wykonać przejście ścieżką we wskazanych elementach przy pomocy akcji Przesuń obieg (SQL).
Pełną listę dostępnych w tym kontekście akcji zawiera rozdział Akcje.

Przekazywanie zewnętrznych danych do automatyzacji

Dane zewnętrzne są przekazywane do automatyzacji za pomocą parametrów wejściowych. Parametry te, zainicjowane zewnętrznymi danymi, można dowolnie wykorzystywać w obrębie automatyzacji oraz w poszczególnych akcjach.

Aby zainicjować parametry wejściowe automatyzacji i nadać im odpowiednie wartości, należy przekazać je w treści żądania w formacie JSON. Nazwy węzłów muszą odpowiadać nazwom zdefiniowanych parametrów wejściowych automatyzacji, np.:

{
    "Param1": "sample value",
    "Param2": 1
}

Dane można również przekazać w query stringu. W takim przypadku nazwy parametrów muszą odpowiadać nazwom parametrów wejściowych zdefiniowanych w automatyzacji., np.:

https://webconbps.com/api/udef/db/1/MyEndpoint?Param1=sample%20value&Param2=1

Jeśli parametry zostały przekazane zarówno w treści żądania jak i w query string wówczas parametry z query string są ignorowane.

Wynik wywołania zwracany jest w formacie JSON. Dane wyjściowe, odpowiadające parametrom wyjściowym automatyzacji, umieszczane są w węźle Data, np.

{
    "Data":
    {
        "Output1": "sample return value",
        "Output2": 23
    }
}

Obsługa błędów

W przypadku wystąpienia błędu podczas wykonywania automatyzacji, standardowo uruchamiana jest automatyzacja Obsługa błędów, a następnie zwracana jest odpowiedź zawierająca kod błędu oraz ewentualny komunikat. Błędy wynikające z logiki biznesowej (np. niepomyślna walidacja danych) zwracają kod błędu HTTP 409. W przypadku błędów wynikających z nieprawidłowej konfiguracji zwracany jest kod błędu HTTP 400.

Jeśli w sekwencji działania automatyzacji zostanie użyty bloczek Przerwij z błędem, w którym zdefiniowano kod błędu z zakresu 400–409, zwrócony zostanie błąd z tym właśnie kodem. W przypadku podania kodu spoza tego zakresu, zwrócony zostanie błąd HTTP 409.