Skip to Content
DocsEngineExtensionsHTTP Service Tasks

HTTP Service Tasks

Die Http Service Task Extension ist eine Erweiterung für die Engine, welche es erlaubt Custom Service Tasks vom Typ Http Service auszuführen.

Funktionsbeschreibung

Ein HTTP Service Task wird verwendet, um HTTP Anfragen gegen externe Dienste auszuführen.

Für die Anfrage können u.a. Parameter wie die Ziel-URL, die zu verwendende HTTP Methode, diverse Request Header und ein Request Body definiert werden. Weitere Infos dazu folgen im Abschnitt Service Task Konfiguration

Der Service Task verwendet die vom externen Dienst empfangene Antwort als End-Token.

Konfiguration

Mit der Studio-Erweiterung Custom Service Tasks lässt sich ein Http Service Task komfortabel über eine passende Oberfläche konfigurieren.

Service Task Konfiguration

Damit ein Service Task von der Extension als HTTP Service Task erkannt wird, muss für diesen Service Task Custom Property engine.setServiceTaskType mit dem Wert HttpService gesetzt werden.

Folgende Parameter können für den HTTP Service Task als Custom Property konfiguriert werden:

  • method: Die zu verwendende HTTP Methode (GET, POST, PUT, DELETE)
  • studio.paramUrl: Die aufzrufende URL
  • studio.paramAuthorization (Optional): Der zu verwendende Authorization Header
  • studio.paramContentType (Optional): Der zu verwendende Content Type Header. Default ist application/json
  • studio.paramBody (Optional): Der zu verewndende JSON-basierte Request Body für POST und PUT Requests

Abgesehen von Method kann jedes dieser Felder durch Runtime Expressions (${}) dynamische Werte zugewiesen bekommen.

Beispiel

Weitere Konfigurationen sind für die Erweiterung nicht erforderlich.