Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Der HTTPRestHandler ermöglicht es dem Benutzer, Anfragen an einen Server zu senden und die zurückgegebene Antwort in einer Prozessvariablen zu speichern. Der Status (Erfolg success oder Fehler error) des Aufrufs wird in die Variable .SYS. <Name der Veranstaltung>_status.

...

Name des Parameters

Standardwert

Beschreibung

Gültige Beispiele

HostNamehostName

Status
colourRed
titleMANDATORY

Dieser Parameter enthält die URL des angeforderten Servers.

Hostname (URL)

Methodemethod

Bereitstellenpost

Dieser Parameter bestimmt, welche Methode remote aufgerufen wird. Bereitstellen bedeutet, dass der Server eine Eingabe im XML-Format erwartet, die er verarbeitet und zurückgibt. Erhalten bedeutet, dass der Server Daten sendet, ohne dass eine Eingabe erforderlich ist.

löschendelete
Erhaltenget
Kopfhead
Optionenoptions
Flickenpatch
Bereitstellenpost
stellenput

templatePath

Status
colourRed
titleMANDATORY
(wenn httpBody (englisch) nicht gesetzt ist)

Dieser Parameter enthält den Dateipfad zu einer JSON-Datei, die die Eingabe für den Server enthält.

Pfad zur Vorlage

getParameter

Dieser Parameter enthält die Eingabe für den Server im JSON-Format.

httpBody (englisch)

Status
colourRed
titleMANDATORY
(wenn templatePath nicht gesetzt ist)

Dieser Parameter enthält die Eingabe für den Server im JSON-Format.

responseVariable

Dieser Parameter enthält die Prozessvariable, in der die Serverantwort gespeichert werden soll.

Benutzeruser

Dieser Parameter ist nur erforderlich, wenn der Server eine Identifizierung erfordert und den Benutzernamen des Benutzers enthält.

bestehenpass

Dieser Parameter wird nur benötigt, wenn der Server eine Identifizierung erfordert und das Kennwort des Benutzers enthält.

authMethod

Status
colourRed
titleMandatory

Dieser Parameter wird nur benötigt, wenn der Server eine Identifizierung erfordert und die Verschlüsselung enthält, die angewendet werden soll. Eine mögliche Verschlüsselung ist base64, die angewendet wird, indem dieser Parameter auf grundlegend basic.

OAuthoauth

grundlegendbasic

oAuthGrantTypeAccess

Passwortpassword

Dieser Parameter beschreibt den OAuth-Gewährungstyp, der in der Anforderung verwendet werden soll. Weitere Optionen: https://oauth.net/2/grant-types/

oAuthGrantTypeRefresh

refresh_token

Dieser Parameter sollte zusammen mit dem Wert Aktualisierungstoken enthalten sein und wird verwendet, um ein Zugriffstoken abzurufen.

oAuthClientId

Status
colourRed
titleMANDATORY
(wenn authMethod == "OAuth" oauth)

Dieser Parameter ist ein öffentlicher Bezeichner für die Anwendungen, d. h. eine öffentlich verfügbar gemachte Zeichenfolge, die von der Dienst-API zur Identifizierung der Anwendung verwendet wird.

oAuthClientSecret

Status
colourRed
titleMANDATORY
(wenn authMethod == "OAuth" oauth)

Dieser Parameter ist ein geheimes Geheimnis, das nur der OAuth-Anwendung und dem Autorisierungsserver bekannt ist. Es wird vom Autorisierungsserver während des Prozesses der Anwendungsregistrierung generiert. Ein Client muss seinen geheimen Clientschlüssel bereitstellen, um sich beim Autorisierungsserver zu authentifizieren.

oAuthTokenUrl

Status
colourRed
titleMANDATORY
(wenn authMethod == "OAuth")Nur erforderlich, wenn authMethod = "oauth" oauth)

Teilt die URL auf, von der das OAuth-Token abgerufen werden soll.

oAuthTokenBasicAuth

FALSCH

Dieser Parameter wird verwendet, um das Token für die Standardauthentifizierung festzulegenfalse

Wenn dies true, rufen wir das OAuth-Zugriffstoken ab, indem wir die nicht leeren Werte der Parameter oAuthClientId und oAuthClientSecret als Parameter für Basic Auth verwenden.

additionalFields

Dieser Parameter wird verwendet, um dem Rest zusätzliche Felder hinzuzufügen.

additionalHeaders

Dieser Parameter wird verwendet, um zusätzliche Header zum Rest hinzuzufügen.

call"&method=GET&additionalHeaders=[NAME_OF_VARIABLE=" + Variable + ";" + "NAME_OF_VARIABLE2=" + Variable2 + "]"

searchByJsonPath

null

Hier wird der Json-Pfad für einen bestimmten Teil der zurückgegebenen Json-Datei und ein Variablenname, unter dem der spezifische Teil des Jsons gespeichert werden soll, eingetragen. Die Variable(n) werden dann in einem Array mit dem Namen "result" gespeichert. Zum besseren Verständnis siehe Beispiele.

[{path: "[*]", resultVariable: "variable_name"}]

contentType (Inhaltstyp)

Dieser Parameter gibt den Inhaltstyp der Anforderung an.

newLineReplacement

Ersetzt alle \n mit dem angegebenen Wert, es sei denn, FALSCH wird als Wert bereitgestellt.

urlEncoding (url-Kodierung)

STIMMTtrue

Wenn diese Option aktiviert ist, wird die URL in eine US-ASCII-Zeichenfolge konvertiert. Darüber hinaus werden eckige Klammern mit ihren jeweiligen ASCII-Werten versehen.

convertBodyToJson

FALSCHfalse

Dieser Parameter wird verwendet, um die Abfrageparameter in eine JSON-Zeichenfolge zu konvertieren.

addNote

FALSCHfalse

Wenn diese Option aktiviert ist, wird die Antwort als Notiz gespeichert und an die aktuelle Prozessinstanz angehängt.

addAllDocuments

FALSCHfalse

Wenn diese Option aktiviert ist, wird eine mehrteilige Anforderung erstellt, die alle angehängten Dokumente enthält.
Nur relevant für PUT-Anfragen.

addLocalDocument

Dieser Parameter fügt eine lokale Datei über den angegebenen Pfad hinzu.

logResponse (englisch)

Wenn diese Option aktiviert ist, wird die Antwort im Serverprotokoll abgemeldet.

logRequest (logAnfrage)

STIMMTtrue

Wenn diese Option aktiviert ist, wird die Anforderung im Serverprotokoll abgemeldet.

faultTolerance

1

Dieser Parameter kann entweder als 0 oder 1 angegeben werden. Es macht nur einen Unterschied, wenn eine Ausnahme ausgelöst wird. Wenn eine Ausnahme ausgelöst wird, wird der Prozess gestoppt, wenn der Parameter auf 0 gesetzt ist, und wenn er auf 1 gesetzt ist, wird die Ausnahmemeldung in der responseVariable gespeichert und der Prozess kann wie gewohnt fortgesetzt werden.

0

1

onErrorRepetition

0

Wiederholen Sie die Ausführung, wenn eine fehlerhafte Anforderung vorliegt (wenn es sich um eine IOException (wie 403, 401) handelt)

isRestCallButton

FALSCHfalse

Dieser Parameter wird verwendet, wenn Sie den Rest-Handler über eine TSD-Schaltfläche aufrufen möchten.

...

Ereignistyp

Knoten-Leave

Name der Aktion

com.dooris.bpm.actionhandler.HttpRestHandler

Action-Klasse

com.dooris.bpm.actionhandler.HttpRestHandler

Parameter

hostName=https://yourcompanyserver.com/rest/list/${customerList};

Methode method = BeitragPost;

postParameter={

"Firma":"${customer_company}",

"Vorname":"${customer_firstname}",

"Nachname":"${customer_lastname}",

"email":"${customer_email}",};

user=John.Doe;

pass=specialPW;

authMethod=Basisbasic;

responseVariable=responseVar;

faultTolerance=0;

...