Post-Request

Aktionen des Typs POST-Request ermöglichen es, Formulardaten als POST-Request an die angegebene URL zu senden und stellt dadurch eine Universalschnittstelle zu anderen Diensten dar.

Parameter

Details für den POST Request

Sende URL

Stellt die Adresse dar, an die das POST-Request geschickt werden soll.

XSL-Template

In den meisten Fällen wird der externe Dienst, an den das POST-Request übertragen wurde, eine Antwort in Form von XML oder HTML zurückliefern. In einigen Fällen kann es notwendig sein, dass diese zur Anzeige gebracht oder in anderen Aktionen weiterverarbeitet werden sollen. Über die Auswahl eines XSL-Templates haben Sie die Möglichkeit, die zurücklieferte Antwort aufzubereiten oder anders zu formatieren.

Zeichensatz des Aufrufs

Legt fest, mit welchem Zeichensatz das POST-Request gesendet wird.

Zeichensatz der Antwortseite

Legt fest, mit welchem Zeichensatz die Antwort entgegengenommen werden soll.

Als Abschlussseite bereitstellen

Liefert die Antwort der Aktion an den Client aus. Bei deaktivierter Option wird die Standardantwort von FORMCYCLE ausgeliefert.

Zusätzliche Parameter

Zusätzliche Header

Hier kann eine Liste von Header hinterlegt werden, die in jedem Fall übertragen werden.

Alle Formularwerte übertragen

Ist die Möglichkeit alle aus dem Formular erfassten Daten weiterzuleiten. Der Name des Formularelementes bzw. der Alias ist hierbei der Feldbezeichner innerhalb des POST-Request. Der Wert ist die Eingabe aus dem Formular.

Aliasnamen verwenden (für Formularelemente und Uploads)

Formularfelder werden mit ihren Formularfeldaliasen anstatt mit den Formularfeldnamen übertragen.

Zusätzliche Parameter

Hier kann eine Liste von Parametern hinterlegt werden, die in jedem Fall übertragen werden. Häufig werden hier zusätzliche statische Informationen hinterlegt, die von dem externen Dienst benötigt werden, oder wenn Feldbezeichner anders als im Formular hinterlegt erwartet werden.

Dateien zum Request hinzufügen (Multipart-Request)

Dateien

Auswahl von Dateien die zum Request hinzugefügt werden können.

Erweiterte Verbindungseinstellungen

HTTP Basic-Authentifizierung

Verwendung der HTTP Basic-Authentifizierung

Name: Benutzername für die URL

Passwort: Passwort für den Benutzer

Proxy-Server benutzen

Weiterleitung an einen Proxy-Server

Proxy-Server Hostname: Name des Proxy-Servers

Port: Port des Proxy-Servers. Standard ist 80.

Proxy Authentifizierung: Authentifizierung am Proxy-Server

Login: Benutzername für den Proxy-Server

Passwort: Passwort für den Proxy-Benutzer

Ablage der erzeugten Dateien

An den Vorgang anhängen

Wenn diese Option angewählt wird, werden in dieser Aktion erzeugte Dateien an den Vorgang angehangen. Ansonsten stehen Sie nur innerhalb des Workflows für Aktionen innerhalb der selben Verarbeitungskette zur Verfügung.

Aktionsplatzhalter

Aktionen vom Typ Post-Request stellen Aktionsplatzhalter bereit, welche  in darauf folgenden Aktionen verwendet werden können.

Standardplatzhalter

[%$<Aktionsname>.SUCCESS%]

Rückgabe ob Aktion erfolgreich ausgeführt wurde. Liefert Boolean (true/false) zurück.

[%$<Aktionsname>.RESULT%]

Rückgabe aller von der Aktion bereitgestellten Ergebnisse in strukturierter Form.

[%$<Aktionsname>.ERROR_CODE%]

Der geworfene Fehler-Code im Fehlerfall der Aktion. Leer wenn kein Fehler aufgetreten ist.

[%$<Aktionsname>.ERROR_MESSAGE%]

Die geworfene Fehler-Nachricht im Fehlerfall der Aktion. Leer wenn kein Fehler aufgetreten ist.

Aktionsspezifische Platzhalter

[%$<Aktionsname>.RESULT.redirectUrl%]

Enthält im Fall einer Weiterleitung die URL zum Ziel

[%$<Aktionsname>.RESULT.redirected%]

Liefert true zurück, wenn die HTTP-Anwort in einer Weiterleitung resultiert, sonst false.

[%$<Aktionsname>.RESULT.responseBody%]

Enthält die Antwort, die durch den ausgelösten POST-Request zurückgeliefert wurde. Im Fall einer Weiterleitung ist dieser Wert leer.

[%$<Aktionsname>.RESULT.responseCode%]

Enthält den zurückgelieferten HTTP-Statuscode

[%$<Aktionsname>.RESULT.responseJson%]

Enthält ein JSON-Objekt oder JSON-Array, wenn es sich bei der HTTP-Antwort nicht um eine Weiterleitung handelt und der content-type des zurückgegebenen Inhalt application/json ist

[%$<Aktionsname>.RESULT.responseReasonPhrase%]

Enthält im Falle eines erfolgreichen POST-Requests die Statusnachricht, wie etwa "OK" oder "Found"

[%$<Aktionsname>.RESULT.responseStatusLine%]

Enthält im Falle eines erfolgreichen POST-Requests die Statusnachricht, wie etwa "OK" oder "Found"

[%$<Aktionsname>.ERROR.message%]

Fehlernachricht, der zurückgeliefert wird, wenn die angebene externe URL-Ressource keinem gültigen Format entspricht, der angebundene Server nicht erreicht werden kann oder keine Antwort zurückliefert, beim Hinzufügen von Dateien zum Post-Request Fehler aufgetretten ist oder die konfiguriert XSLT-Transformation fehlgeschlagen ist.