SOAP Verbindung

Einführung

Eine SOAP -Verbindung wird mithilfe des SOAP -Connectors konfiguriert, der den Zugriff auf einen SOAP Webdienst ermöglicht. Sobald eine Verbindung hergestellt ist, können Sie eine oder mehrere mit dieser Verbindung verknüpfte SOAP Aktivitäten konfigurieren, die entweder als Quelle zur Bereitstellung von Daten für einen Operation oder als Ziel zur Nutzung von Daten in einem Operation verwendet werden können.

Erstellen oder Bearbeiten einer SOAP Verbindung

Eine neue SOAP -Verbindung wird mithilfe des SOAP -Connectors von einem dieser Standorte aus erstellt:

• Die Tab Endpoints und -konnektoren der Designkomponentenpalette (siehe Komponentenpalette).

Eine vorhandene SOAP -Verbindung kann von diesen Orten aus bearbeitet werden:

• Die Tab Endpoints und -konnektoren der Designkomponentenpalette (siehe Komponentenpalette).
• Die Tab Komponenten des Projektbereichs (siehe Aktionsmenü im Projektbereich Tab Komponenten).

Konfigurieren einer SOAP Verbindung

Die Konfiguration einer SOAP -Verbindung umfasst diese Felder:

• Endpoint: Geben Sie einen Namen ein, der zur Identifizierung der SOAP -Verbindung verwendet wird. Der Name muss für jede SOAP -Verbindung eindeutig sein und darf keine Schrägstriche enthalten (/) oder Doppelpunkte (:) Dieser Name wird auch zur Identifizierung des SOAP Endpoint verwendet, der sich sowohl auf eine bestimmte Verbindung als auch auf ihre Aktivitäten bezieht.

• URL hochladen, Datei hochladen oder Vorhandenes auswählen: Verwenden Sie das Optionsfeld, um die Quelle der WSDL-Datei (Web Services Description Language) auszuwählen, die Sie hochladen oder wiederverwenden möchten. Es können Dateien mit einer Größe von bis zu 5 MB hochgeladen werden.

  • URL hochladen: Geben Sie die URL der WSDL-Datei in das Textfeld ein und klicken Sie dann auf die Schaltfläche Hochladen. Die URL muss ohne Authentifizierung zugänglich sein, sonst erhalten Sie eine Fehlermeldung. Wenn Sie eine WSDL mit demselben Namen wie eine vorhandene WSDL hochladen, lesen Sie Ersetzen einer hochgeladenen WSDL weiter unten auf dieser Seite.

  • Datei hochladen: Verwenden Sie die Schaltfläche Durchsuchen rechts, um zu einer WSDL- oder ZIP-Datei zu navigieren. Wenn Sie eine ZIP-Datei bereitstellen, muss diese eine einzelne WSDL-Datei enthalten, sie kann jedoch auch alle XSD-Dateien enthalten, von denen die WSDL abhängig ist. Klicken Sie dann auf die Schaltfläche Hochladen. Wenn Sie eine WSDL mit demselben Namen wie eine vorhandene WSDL hochladen, lesen Sie Ersetzen einer hochgeladenen WSDL weiter unten auf dieser Seite.

    Hinweis

    Beliebig schemaLocation muss mithilfe einer relativen Referenz in eine lokale Datei aufgelöst werden. Dies bedeutet normalerweise, dass anstelle der Bereitstellung eines Tupels wie diesem:

    ``` xsi:schemaLocation='http://schemas.xmlsoap.org/wsdl/mime/ http://ws-i.org/profiles/basic/1.1/wsdlmime-2004-08-24.xsd'

    Stattdessen würden Sie Folgendes angeben:
    
     ```
    xsi:schemaLocation='http://schemas.xmlsoap.org/wsdl/mime/ wsdlmime-2004-08-24.xsd'
    

    Im obigen Beispiel die XSD-Datei wsdlmime-2004-08-24.xsd befindet sich entweder im selben Verzeichnis oder auf einem Pfad relativ zum geladenen WSDL.

  • Vorhandenes auswählen: Verwenden Sie das Dropdown-Menü, um eine vorhandene WSDL-Datei auszuwählen, die zuvor im aktuellen Projekt verwendet wurde.

• Port: Verwenden Sie die Dropdown-Liste, um den entsprechenden Port auszuwählen.

• Webdienst-URL: Geben Sie eine gültige URL für den Webdienst ein. Standardmäßig wird dieses Feld mit der URL aus der WSDL ausgefüllt.

• Dienst und Bindung: Standardmäßig werden diese Felder automatisch auf Grundlage der bereitgestellten WSDL und des Port ausgefüllt und können nicht bearbeitet werden.

• Optionale Einstellungen: Klicken Sie hier, um weitere optionale Einstellungen einzublenden:

  

  • Inhaltskodierung aktivieren: Wenn ausgewählt, wird der Accept-Encoding- Header mit der von Harmony unterstützten Kodierung gesendet. Derzeit wird Gzip unterstützt.

  • Chunked Transfer Encoding aktivieren: Wenn ausgewählt, wird der Header Transfer-Encoding: chunked gesendet. Verwenden Sie diese Option, wenn Sie große Datensätze übertragen.

  • Send Expect: 100-continue: Wenn ausgewählt, wird der Header Expect: 100-continue gesendet. Mit dieser Option werden keine Daten gesendet, bis der HTTP-Server die Header validiert hat. Verwenden Sie diese Option, wenn Sie große Datenmengen senden, aber keine Chunked-Transfer-Kodierung verwenden möchten.

  • Schwache Chiffren zulassen: Aktivieren Sie dieses Kontrollkästchen, um mit HTTP-Servern zu kommunizieren, die schwache Chiffren (DES/3DES und RC4) verwenden.

  • Accept-Encoding auf Gzip setzen: Standardmäßig ausgewählt, teilt dies dem HTTP-Server mit, dass Harmony eine Gzip-komprimierte Antwort akzeptieren kann. Im Gegenzug befolgt Harmony den RFC 1952-Standard und dekomprimiert Gzip HTTP-Antworten automatisch. Wenn der Server Gzip nicht verwendet, erkennt Harmony, dass die Antwort nicht komprimiert ist und verarbeitet sie wie gewohnt.

    Notiz

    Diese Einstellung hat nichts mit dem Gzip Connector zu tun.

  • SSL-Version: Verwenden Sie das Dropdown-Menü, um eine bestimmte SSL-Version auszuwählen, wenn der HTTP-Server dies erfordert.

  • Anforderungsheader: Jeder in dieses Feld eingegebene Text wird als HTTP- Header gesendet. Geben Sie jeden Header in einer Zeile an, es sei denn, der Header wird gemäß dem HTTP-Standard umbrochen. Dieses Feld unterstützt auch die Verwendung von globalen Variablen, Projektvariablen und Jitterbit-Variablen durch Ersetzen der Variablen in eckigen Klammern [ ] mit ihren Werten.

• Benutzername und Passwort: Geben Sie ggf. einen Benutzernamen und ein Passwort ein, die den Zugriff auf die WSDL ermöglichen. Lassen Sie diese Felder leer, wenn kein Benutzername oder Passwort erforderlich ist.

  Standardmäßig verhandelt Harmony mit dem Endpoint, um zu bestimmen, welche Authentifizierungsmethoden unterstützt werden, und verwendet die bereitgestellten Anmeldeinformationen für eines der Protokolle. Harmony unterstützt diese HTTP-Authentifizierungsoptionen:

  • HTTP-Grundlagen
  • HTTP-Digest
  • HTTP Digest mit Authentifizierung mit einer IE-Variante

• Zertifikat: Wählen Sie aus der Dropdown-Liste ein verfügbares Zertifikat zur Authentifizierung beim HTTP-Server aus. Sie können clientseitige SSL-Zertifikate über die Management Console verwalten unter Anpassungen > Client-Zertifikate.

• Wiederholen: Funktioniert nur bei Verwendung einer Umfeld, die einer privaten Agentengruppe zugeordnet ist. Diese Einstellung wird verwendet, um eine Anforderung zu wiederholen, wenn ein SOAP Endpoint einen dieser Statuscodes zurückgibt: 500, 501, 502, 503, oder 504.

  Damit diese Einstellung wirksam wird, müssen private Agenten die Version 10.29 oder höher aufweisen. Bei früheren Agentenversionen wird diese Einstellung ignoriert.

  Aktivieren Sie das Kontrollkästchen Wiederholen, um zusätzliche Konfigurationsoptionen zu erweitern:

  

  • Wiederholungsintervall (Sekunden): Geben Sie die Anzahl der Sekunden (maximal 5 Sekunden) ein, die zwischen dem erneuten Senden einer Anforderung an den SOAP Endpoint gewartet werden soll.

  • Maximale Wiederholungen: Geben Sie die Anzahl der Wiederholungen (maximal 5 Wiederholungen) ein, die eine Anfrage an den SOAP Endpoint gesendet wird. Wenn die Anfrage nach der maximalen Anzahl von Wiederholungen immer noch fehlschlägt, wird eine Ausnahme mit einer Fehlermeldung im Operation zurückgegeben. Darüber hinaus protokolliert der private Agent jeden Wiederholungsversuch im jitterbit.log Protokolldatei.

    Jeder Wiederholungsversuch wird als Teil desselben Operation behandelt, wobei nur ein einziger Datensatz im Operation erscheint. Alle Operation, die zum Ausführen nachlegende Vorgänge konfiguriert sind, werden basierend auf dem Endstatus des Operation nach wiederholten Versuchen bis zur maximalen Anzahl an Wiederholungsversuchen ausgelöst.

  Hinweis

  Diese Einstellungen überschreiben die Jitterbit-Variablen jitterbit.web_service_call.retry_wait_seconds Und jitterbit.web_service_call.number_of_retries wenn diese Variablen festgelegt sind.

• Methoden auswählen: Wählen Sie alle Methoden aus, die Ihnen als Quelle oder Ziel in der Operation zur Verfügung stehen sollen.

  Notiz

  Zuvor ausgewählte Methoden, die aktuell von konfigurierten SOAP Aktivitäten verwendet werden, können nicht entfernt werden.

• Ausgewählte Aktivität und Anzeigename: Wenn Sie oben Methoden auswählen, werden diese der Tabelle unten hinzugefügt. Dabei wird jede ausgewählte Methode angezeigt, die als Aktivitätsblock unter der SOAP Verbindung in der Komponentenpalette gerendert wird. Um einen Anzeigenamen zu bearbeiten, klicken Sie auf das Bearbeitungssymbol und geben Sie den gewünschten Aktivitätsnamen ein.

  Hinweis

  Zuvor ausgewählte Aktivitäten, die derzeit als Projektkomponente konfiguriert sind, können nicht entfernt werden.

• Testen: Klicken Sie hier, um die Verbindung mithilfe der bereitgestellten Konfiguration zu überprüfen.

• Änderungen speichern: Klicken Sie hier, um die Verbindungskonfiguration zu speichern und zu schließen.

• Änderungen verwerfen: Klicken Sie nach dem Vornehmen von Änderungen an einer neuen oder vorhandenen Konfiguration hier, um die Konfiguration ohne Speichern zu schließen. Sie werden in einer Meldung aufgefordert, zu bestätigen, dass Sie die Änderungen verwerfen möchten.

• Löschen: Klicken Sie nach dem Öffnen einer vorhandenen Verbindungskonfiguration hier, um die Verbindung dauerhaft aus dem Projekt zu löschen und die Konfiguration zu schließen (siehe Komponentenabhängigkeiten, Löschen und Entfernen). Sie werden in einer Meldung aufgefordert, zu bestätigen, dass Sie die Verbindung löschen möchten.

Ersetzen einer hochgeladenen WSDL

Wenn Sie eine WSDL ersetzen, indem Sie eine WSDL mit demselben Namen erneut hochladen, indem Sie URL hochladen oder Datei hochladen, müssen die WSDL-Operationen dieselben Namen haben wie die WSDL-Operationen, die derzeit von vorhandenen Aktivitäten verwendet werden. Wenn sie nicht dieselben Namen haben oder wenn verwendete WSDL-Operationen in der Ersatz-WSDL fehlen, werden Sie in einer Fehlermeldung aufgefordert, diese Aktivitäten zuerst zu löschen:

Wenn die oben beschriebenen WSDL-Ersetzungskriterien erfüllt sind, listet eine Bestätigungsmeldung die Aktivitäten auf, die durch die Ersetzung der WSDL betroffen sein können, um benachbarte Transformations auf mögliche Zuordnungsfehler zu überprüfen. Nach Bestätigung der Meldung wird die WSDL an allen Stellen ersetzt, an denen sie im gesamten Projekt verwendet wird:

Nächste Schritte

Nachdem eine SOAP Verbindung erstellt wurde, sind Menüaktionen für diese Verbindung über die Tab Komponenten im Projektbereich zugänglich. Siehe Aktionsmenü Verbindungsaktionen für weitere Einzelheiten.

Wenn Sie eine SOAP -Verbindung konfigurieren, können Sie eine oder mehrere mit dieser Verbindung verknüpfte SOAP Aktivitäten so konfigurieren, dass sie entweder als Quelle (zum Bereitstellen von Daten innerhalb einer Operation) oder als Ziel (zum Verwenden von Daten innerhalb einer Operation) verwendet werden.

Verwenden Sie das Dropdown-Menü Anzeigen, um nach Endpoints zu filtern, und klicken Sie dann auf den SOAP Verbindungsblock, um Aktivitäten anzuzeigen, die für die Verwendung mit einer SOAP -Verbindung verfügbar sind:

Die angezeigten Aktivitäten entsprechen den Methoden, die bei der Konfiguration der SOAP -Verbindung ausgewählt wurden.

Weitere Informationen finden Sie unter SOAP Aktivitäten.