SOAP -Verbindung

Einführung

Eine SOAP -Verbindung, die mit dem SOAP Connector erstellt wurde, stellt Verbindungen mithilfe des Simple Object Access Protocol (SOAP) her. Sobald eine Verbindung konfiguriert ist, können Sie Instanzen von SOAP -Aktivitäten erstellen, die mit dieser Verbindung verknüpft sind und entweder als Quellen (zum Bereitstellen von Daten in einer Operation) oder als Ziele (zum Verbrauchen von Daten in einer 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).
• Die Seite Globale Endpoints (siehe Einen globalen Endpoint erstellen in Globale Endpoints).

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

• Die Tab Endpoints und -konnektoren der Designkomponentenpalette (siehe Komponentenpalette).
• Die Tab Komponenten im Projektbereich (siehe Aktionsmenü im Projektbereich Tab Komponenten).
• Die Seite Globale Endpoints (siehe Einen globalen Endpoint bearbeiten in Globale Endpoints).

Konfigurieren einer SOAP -Verbindung

Jedes Benutzeroberflächenelement des SOAP Verbindungskonfigurationsbildschirms wird unten beschrieben.

• Verbindungsname: Geben Sie einen Namen zur Identifizierung der SOAP Verbindung ein. 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 Vorhandene auswählen: Wählen Sie über das Optionsfeld die Quelle der hochzuladenden oder wiederzuverwendenden WSDL-Datei aus. 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 anschließend 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 hochladen, lesen Sie Hochgeladene WSDL ersetzen weiter unten auf dieser Seite.

  • Datei hochladen: Klicken Sie auf Durchsuchen, um eine WSDL- oder ZIP-Datei auszuwählen. Eine ZIP-Datei muss eine WSDL-Datei enthalten und kann XSD-Dateien enthalten, von denen die WSDL abhängt. Klicken Sie anschließend auf Hochladen. Informationen zum Hochladen einer WSDL mit demselben Namen wie eine vorhandene finden Sie unter Hochgeladene WSDL ersetzen unten.

    Notiz

    Beliebig schemaLocation muss mit einer relativen Referenz auf eine lokale Datei verweisen. Dies bedeutet in der Regel, dass anstelle eines Tupels wie diesem Folgendes angegeben wird:

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

    Dies sollte stattdessen angegeben werden:
    
     ```
    xsi:schemaLocation='http://schemas.xmlsoap.org/wsdl/mime/ wsdlmime-2004-08-24.xsd'
    

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

  • Vorhandene auswählen: Wählen Sie aus den WSDL-Dateien aus, die zuvor im aktuellen Projekt verwendet wurden.

• Port: Wählen Sie den entsprechenden Port aus dem Dropdown-Menü.

  Notiz

  Beim Bearbeiten einer Verbindung ist dieses Feld deaktiviert, wenn Sie bereits Aktivitäten für den Endpoint verwenden.

• Webdienst URL: Geben Sie die URL für den Webdienst ein. Standardmäßig wird in dieses Feld die URL aus dem WSDL eingetragen.

• Dienst und Bindung: Diese Felder werden automatisch basierend auf WSDL und Port ausgefüllt und können nicht bearbeitet werden.

• Optionale Einstellungen: Klicken Sie hier, um zusätzliche optionale Einstellungen zu erweitern:

  

  • Inhaltskodierung aktivieren: Wenn diese Option ausgewählt ist, wird der Header Accept-Encoding mit der von Harmony unterstützten Kodierung gesendet (derzeit Gzip).

  • Chunked-Transfer-Encoding aktivieren: Wenn diese Option ausgewählt ist, wird der Header_Transfer-Encoding: chunked_ gesendet. Dies ist nützlich bei der Übertragung großer Datensätze.

  • Senden: Erwartet: 100-weiter: Wenn diese Option aktiviert ist, wird der Header_Erwartet: 100-weiter_ gesendet. Dadurch wird sichergestellt, dass der HTTP-Server die Header validiert, bevor Daten gesendet werden. Dies ist nützlich für das Senden großer Datenmengen ohne Chunked-Transfer-Kodierung.

  • Schwache Verschlüsselungen zulassen: Wählen Sie diese Option aus, um mit HTTP-Servern unter Verwendung schwacher Verschlüsselungen (DES/3DES und RC4) zu kommunizieren.

  • Accept-Encoding auf Gzip setzen: Standardmäßig aktiviert, teilt dies dem HTTP-Server mit, dass Harmony Gzip-komprimierte Antworten akzeptieren kann. Harmony folgt dem RFC 1952-Standard und dekomprimiert Gzip HTTP-Antworten automatisch. Wenn der Server kein Gzip verwendet, erkennt Harmony, dass die Antwort nicht komprimiert ist und verarbeitet sie normal.

    Notiz

    Diese Einstellung hat nichts mit dem Gzip Connector zu tun.

  • SSL-Version: Wählen Sie eine bestimmte SSL-Version aus, wenn der HTTP-Server dies erfordert.

  • Anforderungsheader: Geben Sie HTTP-Header ein, wobei jeder Header in einer eigenen Zeile stehen muss, sofern er nicht gemäß HTTP-Standards umbrochen ist. Dieses Feld unterstützt globale Variablen, Projektvariablen und Jitterbit-Variablen mit eckigen Klammern [ ].

• Benutzername und Passwort: Geben Sie bei Bedarf die Anmeldeinformationen für den Zugriff auf die WSDL ein. Lassen Sie das Feld leer, wenn keine Authentifizierung 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 folgende HTTP-Authentifizierungsoptionen:

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

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

• Wiederholen: Diese Einstellung funktioniert nur in Umgebungen mit einer privaten Agentengruppe. Es versucht erneut, Anfragen zu stellen, wenn ein SOAP Endpoint diese Statuscodes zurückgibt: 500, 501, 502, 503, oder 504.

  Private Agenten müssen mindestens Version 10.29 aufweisen, damit diese Funktion funktioniert. Frühere Agentenversionen ignorieren diese Einstellung.

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

  

  • Wiederholungsintervall (Sekunden): Geben Sie ein, wie lange zwischen den Wiederholungsversuchen gewartet werden soll (maximal 5 Sekunden).

  • Maximale Wiederholungsversuche: Geben Sie an, wie oft (maximal 5) die Anfrage wiederholt werden soll. Schlägt die Anfrage nach allen Wiederholungsversuchen immer noch fehl, wird eine Ausnahme im Operation angezeigt. Der private Agent protokolliert außerdem jeden Wiederholungsversuch im jitterbit.log Datei.

    Alle Wiederholungsversuche zählen als Teil desselben Operation, mit einem einzigen Datensatz im Operation. Alle Operation für nachlegende Vorgänge, die basierend auf dem endgültigen Status nach allen Wiederholungsversuchen ausgelöst werden.

  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 gesetzt sind.

• Methoden auswählen: Wählen Sie alle Methoden aus, die Sie als Quellen oder Ziele in Operationen verfügbar machen möchten.

  Notiz

  Sie können zuvor ausgewählte Methoden, die bereits von SOAP Aktivitäten verwendet werden, nicht entfernen.

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

  Hinweis

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

• Testen: Klicken Sie hier, um die Verbindung anhand 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 Änderungen an einer neuen oder bestehenden Konfiguration hier, um diese ohne Speichern zu schließen. Sie werden in einer Meldung aufgefordert, das Verwerfen der Änderungen zu bestätigen.

• Löschen: Klicken Sie nach dem Öffnen einer bestehenden 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 aufgefordert, das Löschen der Verbindung zu bestätigen.

Ersetzen einer hochgeladenen WSDL

Wenn Sie eine WSDL-Datei durch das Hochladen einer gleichnamigen Datei ersetzen, müssen deren WSDL-Operationen dieselben Namen haben wie die aktuell von vorhandenen Aktivitäten verwendeten. Sollten diese nicht identisch sein oder bereits verwendete WSDL-Operationen in der Ersatz-WSDL fehlen, werden Sie in der folgenden Fehlermeldung aufgefordert, diese Aktivitäten zuerst zu löschen. Die zu löschenden Aktivitäten werden aufgelistet:

Nach dem Löschen listet die folgende Bestätigungsmeldung die Aktivitäten auf, die durch den Ersatz der WSDL beeinträchtigt werden könnten, um benachbarte Transformations auf mögliche Mapping-Fehler zu überprüfen. Nach Bestätigung der Meldung wird die WSDL an allen Stellen im Projekt ersetzt, an denen sie verwendet wird:

Nächste Schritte

Menüaktionen für eine Verbindung und ihre Aktivitätstypen sind über den Projektbereich und die Design-Komponentenpalette zugänglich. Weitere Informationen finden Sie unter Aktionsmenüs in Connector-Grundlagen.

Nachdem Sie eine SOAP -Verbindung konfiguriert haben, können Sie eine oder mehrere mit dieser Verbindung verknüpfte SOAP Aktivitäten konfigurieren, die entweder als Quelle zum Bereitstellen von Daten für einen Operation oder als Ziel zum Verbrauchen von Daten in einem Operation verwendet werden können. Alternativ können Sie die SOAP -Verbindung in einem Script verwenden.

Weitere Informationen finden Sie unter SOAP -Aktivitäten.