Konnektor-Assistent
In der Übersicht der 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.
Step 1: Select Operations
In the first step, you can select the operations that you want to create as Connector calls. Move your selected calls to the right panel by using the arrow icon. Then, click on ‘Edit Operations’.
Schritt 2: Konfigurieren Sie die Vorgänge:
Im zweiten Schritt können Sie den Namen und die Beschreibung der Connector-Aufrufe bearbeiten. Darüber hinaus können Sie bestehende Aufrufe überschreiben. Dies ist z.B. dann relevant, wenn die WSDL geändert wurde und ein Dienst nun zusätzliche Felder liefert. Sie werden gewarnt, wenn ein überschriebener Konnektoraufruf nicht vom Assistenten erstellt wurde oder manuell geändert wurde, nachdem er erzeugt wurde
Wenn Sie die Aufrufe bearbeitet haben, klicken Sie auf “Verbindungsaufrufe 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 Aufruf des SOAP-Connectors zwei Eingabeparameter definiert werden:
| Bindungsname | Das name-Attribut Ihres wsdl:binding-Attributs in Ihrer WSDL-Datei |
| Name | Der Name des Attributs wsdl:operation in der WSDL-Datei für den Vorgang, den Sie im Konnektoraufruf 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 bieten 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:
| Bindungsname | Das name-Attribut Ihres wsdl:binding-Attributs in Ihrer WSDL-Datei. |
| Name | Der Name des Attributs wsdl:operation in der WSDL-Datei für die Operation, die Sie im Konnektoraufruf aufrufen möchten. |
| Streng | Determines whether services (strict == true) or local bindings (strict == false) are used to determine endpoints in the WSDL. If you don’t use the standards, you have to set this parameter. The Data Type is “boolean”. Set the value to “false”. |
| Endpunkt | Indem Sie dies 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:
All possible nodes (even if marked as optional) have to be defined in the Connector Call. They take the same form as in the standard use of the protocol:
soap/<operationName>/<parameterName>, e.g. soap/Query/index
Inline attributes are characterized by this:
soap/<xml-node>/@attribute, e.g. 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:
| Bindungsname | Das name-Attribut Ihres wsdl:binding-Attributs in Ihrer WSDL-Datei. |
| Name | Der Name des Attributs wsdl:operation in der WSDL-Datei für die Operation, die Sie im Konnektoraufruf aufrufen möchten. |
| configuration/soap/soapMode | Bestimmt den Modus, in dem der SOAP-Konnektor arbeitet. |
| Endpunkt | Indem Sie dies 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 ist ein Endpunkt erforderlich |
| 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.
