Konnektor-Assistent
In der Konnektor-Aufruf-Übersicht finden Sie den Konnektor-Assistenten in der oberen rechten Ecke. Durch Anklicken hilft Ihnen der Assistent, die Konnektor-Aufrufe basierend auf der WSDL-URL des definierten Konnektor-Endpunkts zu erstellen.
Schritt 1: Operationen auswählen
Im ersten Schritt können Sie die Operationen auswählen, die Sie als Konnektor-Aufrufe erstellen möchten. Verschieben Sie Ihre ausgewählten Aufrufe mit dem Pfeilsymbol in das rechte Feld. Klicken Sie dann auf ‘Operationen bearbeiten’.
Schritt 2: Operationen konfigurieren:
Im zweiten Schritt können Sie den Namen und die Beschreibung der Konnektor-Aufrufe bearbeiten. Darüber hinaus können Sie vorhandene Aufrufe überschreiben. Dies ist z. B. relevant, wenn sich die WSDL geändert hat und ein Dienst nun zusätzliche Felder liefert. Sie werden gewarnt, wenn ein überschriebener Konnektor-Aufruf nicht vom Assistenten erstellt oder nach der Generierung manuell geändert wurde
Wenn Sie die Aufrufe bearbeitet haben, klicken Sie auf ‘Konnektoraufrufe 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 Konnektor-Aufruf erstellen müssen.
A) Halten Sie sich an das Standardprotokoll
In diesem Fall erfordert der SOAP-Connector-Aufruf die Definition von zwei Eingabeparametern:
| bindingName | Das Namensattribut Ihres wsdl:binding-Attributs in Ihrer WSDL-Datei |
| operationName | Der Name des wsdl:operation-Attributs in Ihrer WSDL-Datei für die Operation, die Sie in Ihrem Konnektor-Aufruf 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-Connectoren bieten einen oder mehrere optionale Parameter mit dem Präfix ‘queryParams/‘.
Diese Felder werden als Query-Parameter an die SOAP-Request-URL angehängt, um zusätzliche Metainformationen bereitzustellen. Es funktioniert auf die gleiche Weise wie queryParams bei REST-Connectoren.
B) Verwenden Sie das Protokoll manuell
In diesem Fall erfordert der SOAP-Connector-Aufruf die Definition von zwei zusätzlichen Eingabeparametern:
| bindingName | Das Namensattribut Ihres wsdl:binding-Attributs in Ihrer WSDL-Datei. |
| operationName | Der Name des wsdl:operation-Attributs in Ihrer WSDL-Datei für die Operation, die Sie in Ihrem Konnektor-Aufruf aufrufen möchten. |
| strict | Bestimmt, ob Services (strict == true) oder lokale Bindungen (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”. Setzen Sie den Wert auf “false”. |
| endpoint | Durch Hinzufügen dieses Parameters können Sie den Endpunkt manuell auswählen. Wenn der Endpunkt nicht gesetzt ist, wird der in der WSDL-Datei definierte Endpunkt verwendet. |
Beispiel:
Alle möglichen Knoten (auch wenn sie als optional gekennzeichnet sind) müssen im Konnektor-Aufruf definiert werden. Sie haben die gleiche Form wie bei der Standard-Verwendung des Protokolls:
soap/<operationName>/<parameterName>, z. B. soap/Query/index
Inline-Attribute sind dadurch gekennzeichnet:
soap/<xml-node>/@attribute, z. B. soap/RequestServerVersion/@Version
C) Verwenden Sie das Protokoll als Experte
In diesem Fall erfordert der SOAP-Connector-Aufruf die Definition von einem oder zwei zusätzlichen Eingabeparametern:
| bindingName | Das Namensattribut Ihres wsdl:binding-Attributs in Ihrer WSDL-Datei. |
| operationName | Der Name des wsdl:operation-Attributs in Ihrer WSDL-Datei für die Operation, die Sie in Ihrem Konnektor-Aufruf aufrufen möchten. |
| configuration/soap/soapMode | Bestimmt den Modus, in dem der SOAP-Connector arbeitet. |
| endpoint | Durch Hinzufügen dieses Parameters können Sie den Endpunkt manuell auswählen. Wenn der Endpunkt nicht gesetzt ist, wird der in der WSDL-Datei definierte Endpunkt verwendet. 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
| Direct | Sendet den SOAP-Envelope direkt. Die WSDL wird nur verwendet, um den korrekten Endpunkt zu bestimmen. |
| Direct_Ignore | Sendet den SOAP-Envelope direkt und gibt das Ergebnis direkt zurück, ohne die WSDL abzurufen und zu parsen. In diesem Modus ist ein Endpunkt erforderlich |
| WSDL | Der Standard-Modus, die WSDL wird zum Parsen der Request-Parameter und des Ergebnisses verwendet. |
Beispiel:
Die Payload muss durch den Parameter soap/ bereitgestellt werden, der ein String sein muss.
Die Payload muss ein gültiger SOAP-Envelope sein.
