Konnektor-Assistent
In der Übersicht über Connector-Anrufe finden Sie den Connector-Assistenten in der oberen rechten Ecke.
Wenn Sie darauf klicken, hilft Ihnen der Assistent, die Connector-Aufrufe basierend auf der WSDL-URL des definierten Connector-Endpunkts zu erstellen.
Schritt 1: Auswählen von Vorgängen Im ersten Schritt können Sie die Vorgänge auswählen, die Sie als Connectoraufrufe erstellen möchten.
Verschieben Sie Ihre ausgewählten Anrufe mit dem Pfeilsymbol in den rechten Bereich.
Klicken Sie dann auf “Operationen bearbeiten”.
Schritt 2: Vorgänge konfigurieren: Im zweiten Schritt können Sie den Namen und die Beschreibung der Connector-Aufrufe bearbeiten.
Wenn Sie die Anrufe bearbeitet haben, klicken Sie auf “Connectorcalls erstellen”.
Manuelle Konfiguration
SOAP ist ein Netzwerkprotokoll.
Sie können sich entweder an den Standard halten, wenn Sie das Protokoll verwenden, wie SAP, oder es manuell verwenden, wie Microsoft. Die Art und Weise, wie das Protokoll verwendet wird, bestimmt, wie Sie Ihren Connector-Aufruf erstellen müssen.
A) Halten Sie sich an das Standardprotokoll
In diesem Fall müssen für den SOAP-Connector-Aufruf zwei Eingabeparameter definiert werden:
bindingName | Das name-Attribut Ihres wsdl:binding-Attributs in Ihrer WSDL-Datei |
operationName | Der Name des Attributs wsdl:operation in der WSDL-Datei für die Operation, die Sie im Connectoraufruf aufrufen möchten |
Beispiel: Parameter, die von der aufgerufenen SOAP-Operation benötigt werden, haben die folgende Form: soap/<operationName>/<parameterName>, z.B. soap/_-ITIZ_-BUS2038_CREATE/index SOAP-Konnektoren liefern einen oder mehrere optionale Parameter mit dem Präfix ‘queryParams/‘.
Diese Felder werden als Abfrageparameter an die SOAP-Anforderungs-URL angehängt, um zusätzliche Metainformationen bereitzustellen.
Es funktioniert auf die gleiche Weise wie queryParams für REST-Konnektoren .
B) Verwenden Sie das Protokoll manuell
In diesem Fall müssen für den SOAP Connector Call zwei zusätzliche Eingabeparameter definiert werden:
bindingName | Das name-Attribut Ihres wsdl:binding-Attributs in Ihrer WSDL-Datei. | ||||||||
operationName | Der Name des Attributs wsdl:operation in der WSDL-Datei für den Vorgang, den Sie im Connectoraufruf aufrufen möchten. | ||||||||
Streng | Legt fest, ob Dienste (strict == true) oder lokale Bindings (strict == false) verwendet werden, um Endpunkte in der WSDL zu bestimmen. Wenn Sie die Standards nicht verwenden, müssen Sie diesen Parameter setzen. Der Datentyp ist “boolean”. Legen Sie den Wert auf “false” fest.allEndpunkt Wenn Sie diesen als Parameter hinzufügen, können Sie den Endpunkt manuell auswählen. Wenn der Endpunkt nicht gesetzt ist, wird der Endpunkt verwendet, der in der WSDL-Datei definiert ist.Beispiel: Alle möglichen Knoten (auch wenn sie als optional markiert sind) müssen im Connector Call definiert werden. Sie haben die gleiche Form wie bei der Standardverwendung des Protokolls: soap/<operationName>/<parameterName, z.B. soap/Query/index Inline-Attribute zeichnen sich dadurch aus: soap/<xml-node>/@attribute, z.B. soap/RequestServerVersion/@VersionC) Nutzen Sie das Protokoll als Experte In diesem Fall müssen für den SOAP Connector Call ein oder zwei zusätzliche Eingabeparameter definiert werden: | bindingName | Das name-Attribut Ihres wsdl:binding-Attributs in Ihrer WSDL-Datei. | operationName | Der Name des Attributs wsdl:operation in der WSDL-Datei für den Vorgang, den Sie im Connectoraufruf aufrufen möchten. | configuration/soap/soapMode | Bestimmt den Modus, in dem der SOAP-Konnektor arbeitet. | WSDL | Der Standardmodus, die WSDL, wird zum Parsen der Anforderungsparameter und des Ergebnisses verwendet. |
Endpunkt | Wenn Sie diesen als Parameter hinzufügen, können Sie den Endpunkt manuell auswählen. Wenn der Endpunkt nicht gesetzt ist, wird der Endpunkt verwendet, der in der WSDL-Datei definiert ist. |
Beispiel: Alle möglichen Knoten (auch wenn sie als optional markiert sind) müssen im Connector Call definiert werden.
Sie haben die gleiche Form wie bei der Standardverwendung des Protokolls: soap/<operationName>/<parameterName>, z.B. soap/Query/index Inline-Attribute zeichnen sich dadurch aus: soap/<xml-node>/@attribute, z.B. soap/RequestServerVersion/@Version
C) Nutzen Sie das Protokoll als Experte
In diesem Fall müssen für den SOAP Connector Call ein oder zwei zusätzliche Eingabeparameter definiert werden:
bindingName | Das name-Attribut Ihres wsdl:binding-Attributs in Ihrer WSDL-Datei. |
operationName | Der Name des Attributs wsdl:operation in der WSDL-Datei für den Vorgang, den Sie im Connectoraufruf aufrufen möchten. |
configuration/soap/soapMode | Bestimmt den Modus, in dem der SOAP-Konnektor arbeitet. |
Endpunkt | Wenn Sie diesen als Parameter hinzufügen, können Sie den Endpunkt manuell auswählen. Wenn der Endpunkt nicht gesetzt ist, wird der Endpunkt verwendet, der in der WSDL-Datei definiert ist. Wenn der SOAP-Modus (Direct_Ignore) verwendet wird, muss der Endpunkt angegeben werden, da sonst eine Ausnahme auftritt. |
Die möglichen SOAP-Modi sind die folgenden:
Direkt | Sendet den SOAP-Umschlag direkt. Die WSDL wird nur zum Ermitteln des richtigen Endpunkts verwendet. |
Direct_Ignore | Sendet den SOAP-Envelope direkt und gibt das Ergebnis direkt zurück, ohne die WSDL zu holen und zu parsen. In diesem Modus wird ein Endpunkt benötigt |
WSDL | Der Standardmodus, die WSDL, wird zum Parsen der Anforderungsparameter und des Ergebnisses verwendet. |
Beispiel: Die Nutzlast muss durch den Parameter soap/ bereitgestellt werden, der ein String sein muss.
Bei der Nutzlast muss es sich um einen gültigen SOAP-Umschlag handeln.