| UI Button | ||||
|---|---|---|---|---|
|
UI Button color red title Gen. 24 Core und Enterprise url https://hilfe.microtech.de/x/AYDvHw
Inhalt
| Table of Contents |
|---|
Über die Anweisungsart "Http-Post Befehl senden" ist es möglich, einen POST-Befehl an eine URL zu senden. Als Daten können z. B. Selektionsfelder verwendet werden. Die Einstellungen finden Sie im Bereich der jeweiligen Parameter unter dem Eintrag "Regeln".
Die Regel-Anweisung steht in folgenden Bereichen zur Verfügung:
| Regel | Weitere Informationen | |||||
|---|---|---|---|---|---|---|
| ||||||
Regeln mit der Anweisungsposition "Zum Ausführen von Bereichs-Aktionen" |
| |||||
|
Die Funktion "Http-Post Befehl senden" ist für Unternehmen gedacht, die z. B. eine Schnittstelle zu einer externen Website nutzen wollen. Dies kann beispielsweise eine Online-Ticketplattform für Konzertkarten sein, welche das entsprechende Verfahren unterstützt. Über HTTP-POST-Request kann über einen eigenen Ablauf in büro+ / ERP-complete beispielsweise der Login auf einer Website durchgeführt werden und die Übergabe von mehreren Parametern wie etwa Name, Anschrift Wohnort, Veranstaltungsart erfolgen.
...
Über die Regelanweisungen kann die Art „Http-Post Befehl senden" abgesetzt werden.
Das Feld Parameter wird über den Feldeditor gestaltet.
Für den Http POST-Request stehen folgende Felder zur Verfügung:
- URL: Angesprochene URL
- Header: Name und Wert werden durch ein Gleichheitszeichen ("=") getrennt, z. B. Name=Wert. Mehrere Parameter können über das Kaufmanns-Und ("&") angegeben werden
- Format: Für den HTTP POST-Request stehen verschiedene Formate zur Verfügung, die über das Auswahlfeld gewählt werden
- Parameter
Die Bedeutung der einzelnen Felder werden im Folgenden genauer behandelt.
Aufbau des HTTP POST-Request in Regel-Anweisungen
...
| Info | ||
|---|---|---|
| ||
Die Daten werden beim Absenden des Formulars mit einer POST-Anfrage an den Server geschickt. Dabei ist der Datensatz nicht Teil der URL, sondern wird, durch eine Leerzeile getrennt, an den Header angehängt. Auf diese Weise können die Daten für den Client unsichtbar im Hintergrund übermittelt werden. Im Gegensatz zum HTTP GET-Befehl, verbleiben HTTP POST-Requests weder im Arbeitsspeicher, noch werden sie in der Browser-Chronik gespeichert. |
Format
Für den HTTP POST-Request stehen verschiedene Formate zur Verfügung:
- Parameter (x-www-form-urlencoded): Wird genutzt, um einfache ASCII-Text-Daten im Format Key=Value Pairs zu übermitteln. Die Nutzdaten innerhalb dieser Übertragungseinheit sind ähnlich zu Query-Paramatern
- Body (freier Text)
- Body (Text im CSV-Format)
- Body (JSON-Format)
- Body (XML-Format)
Body
Über diese Auswahl können spezifische Anfragen an den jeweiligen Webservice aufgebaut und dynamisch aufgrund der Daten des jeweiligen Datensatz belegt werden.
Kennzeichen: URL-Encoding für Header benutzen
Mit Aktivierung des Kennzeichens lässt sich für die Regel auch ein HTTP POST-Request mit URL-Encoding absetzen. Soll kein URL-Encoding genutzt werden, ist das Kennzeichen zu deaktivieren.
Innerhalb der Regelanweisung mit der Art "Http-Post Befehl senden" kann unterhalb des Felds URL der Header angegeben werden. Beachten Sie dazu, dass die Eingabenotation folgendermaßen aufgebaut ist:
| Code Block |
|---|
[Name]: [Value] |
Jedes Paar muss in einer separaten Zeile stehen. Das Paar wird durch einen Doppelpunkt gefolgt von einem optionalen Leerzeichen in Name und Value getrennt.
Als Beispiel:
| Code Block |
|---|
Test: Aus
Absender: microtech |
| Note | ||
|---|---|---|
| ||
|
Zuweisungen zum Aktualisieren
Formel-Bedingung
Innerhalb der Regelanweisung kann über eine Bedingung festgelegt werden, ob nachfolgende Zuweisungen in den Datensatz zurückgeschrieben werden.
Feld mit Feldzuweisung und Vorgabewert füllen
Trifft die Formel zu, kann darüber ein Feld über eine Feldzuweisung gelöscht oder mit einem von Ihnen definierten Vorgabewert gefüllt werden.
Rückantwort in separate Datenfelder zurückschreiben
StatusCode, StatusText, ResponseText & ResponseHeaders zurückschreiben
Der Rückantworten können in separate Datenfelder zurückgeschrieben werden.
| Info | ||
|---|---|---|
| ||
Wurde keine Bedingung angegeben, wann die angegebene Zuweisung greift, so wird die angegebene Zuweisung immer ausgeführt. |
Innerhalb der Zuweisungen stehen folgende Felder bereit:
- Status Code [StsCode]
- Status Text [StsText]
- Response Text [RespText]
- Response Headers [RespHeaders]
Um einen Wert aus den Response Headers auszulesen, kann die Funktion $DSInfo genutzt werden.
Beispiel:
| Code Block |
|---|
$DSInfo(«RespHeaders»,Vary,Text,: )] |
"Vary" ist dabei der Name im Header. Der Parameter "Text" zeigt auf, das es sich um ein Text-Format handelt. Der Doppelpunkt ":" legt das Trennzeichen fest.
| Tip | ||
|---|---|---|
| ||
Nehmen Sie ein Info-Feld, um den "Header" als ganzes zu speichern. Nachfolgend lässt sich z. B. "Vary" auslesen mit folgendem Aufbau:
|
Beispiel: Ein Response-Text lässt sich in ein "Selektionsfeld 3" im Bereich der Adressen zurück schreiben
In diesem Beispiel wird die Antwort immer rückgespeichert. Es findet ein HTTP-Post-Abgleich des Adress-Status statt. Daten werden gesendet, der zurück gemeldete Status wird in das Selektionsfeld 3 "Http Status" geschrieben.
Protokolleintrag speichern
In den PARAMETERN ist die Protokollierung im Bereich: SONSTIGE - PARAMETER FÜR DAS EREIGNIS-PROTOKOLL über das Kennzeichen "HTTP Anfragen protokollieren" zu aktivieren.
