SOAP-Verbindung

Einführung

Eine SOAP-Verbindung, die mit dem SOAP-Connector erstellt wurde, stellt Verbindungen über das Simple Object Access Protocol (SOAP) her. Sobald eine Verbindung konfiguriert ist, können Instanzen von SOAP-Aktivitäten erstellt werden, die mit dieser Verbindung verknüpft sind, um entweder als Quellen (um Daten in einem Vorgang bereitzustellen) oder als Ziele (um Daten in einem Vorgang zu konsumieren) verwendet zu werden.

Erstellen oder Bearbeiten einer SOAP-Verbindung

Eine neue SOAP-Verbindung wird mit dem SOAP-Connector an einem dieser Orte erstellt:

• Der Registerkarte Projektendpunkte und -connectoren in der Designkomponentenpalette (siehe Designkomponentenpalette).
• Der Seite Globale Endpunkte (siehe Erstellen eines globalen Endpunkts in Globale Endpunkte).

Eine vorhandene SOAP-Verbindung kann an diesen Orten bearbeitet werden:

• Der Registerkarte Projektendpunkte und -connectoren in der Designkomponentenpalette (siehe Designkomponentenpalette).
• Der Registerkarte Komponenten im Projektbereich (siehe Aktionsmenü für Komponenten in Projektbereich Komponenten-Registerkarte).
• Der Seite Globale Endpunkte (siehe Bearbeiten eines globalen Endpunkts in Globale Endpunkte).

Konfigurieren einer SOAP-Verbindung

Jedes Benutzeroberflächenelement des Konfigurationsbildschirms für die SOAP-Verbindung wird im Folgenden beschrieben.

• Verbindungsname: Geben Sie einen Namen ein, um die SOAP-Verbindung zu identifizieren. Der Name muss für jede SOAP-Verbindung einzigartig sein und darf keine Schrägstriche (/) oder Doppelpunkte (:) enthalten. Dieser Name wird auch verwendet, um den SOAP-Endpunkt zu identifizieren, der sich sowohl auf eine spezifische Verbindung als auch auf deren Aktivitäten bezieht.

• Upload-URL, Datei hochladen oder Vorhandenes auswählen: Verwenden Sie die Optionsschaltfläche, um die Quelle der WSDL-Datei auszuwählen, die hochgeladen oder wiederverwendet werden soll. Dateien mit einer Größe von bis zu 5 MB können hochgeladen werden.

  • Upload-URL: 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, andernfalls erhalten Sie einen Fehler. Wenn Sie eine WSDL mit demselben Namen wie eine vorhandene WSDL hochladen, siehe Ersetzen einer hochgeladenen WSDL 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 beinhalten, von denen die WSDL abhängt. Klicken Sie dann auf Hochladen. Für das Hochladen einer WSDL mit demselben Namen wie eine vorhandene, siehe Ersetzen einer hochgeladenen WSDL weiter unten.

    Hinweis

    Jede schemaLocation muss auf eine lokale Datei mit einem relativen Verweis zeigen. Dies bedeutet normalerweise, dass anstelle der Angabe 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'
    

    Dies an seiner Stelle angegeben werden sollte:

    xsi:schemaLocation='http://schemas.xmlsoap.org/wsdl/mime/ wsdlmime-2004-08-24.xsd'
    

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

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

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

  Hinweis

  Beim Bearbeiten einer Verbindung ist dieses Feld deaktiviert, wenn Sie bereits Aktivitäten für den Endpunkt in Verwendung haben.

• Webservice-URL: Geben Sie die URL für den Webservice ein. Standardmäßig wird dieses Feld mit der URL aus dem WSDL ausgefüllt.

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

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

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

  • Chunked Transfer-Encoding aktivieren: Wenn ausgewählt, wird der Transfer-Encoding: chunked-Header gesendet. Dies ist nützlich, wenn große Datensätze übertragen werden.

  • Send Expect: 100-continue: Wenn ausgewählt, wird der Expect: 100-continue-Header gesendet. Dies stellt sicher, dass der HTTP-Server die Header validiert, bevor Daten gesendet werden. Dies ist nützlich, um große Datenmengen ohne Chunked Transfer-Encoding zu senden.

  • Schwache Chiffren zulassen: Wählen Sie aus, 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 Gzip-komprimierte Antworten akzeptieren kann. Harmony folgt dem RFC 1952-Standard und dekomprimiert Gzip-HTTP-Antworten automatisch. Wenn der Server Gzip nicht verwendet, erkennt Harmony, dass die Antwort nicht komprimiert ist, und behandelt sie normal.

    Hinweis

    Diese Einstellung steht in keinem Zusammenhang mit dem Gzip-Connector.

  • 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 steht, es sei denn, sie sind gemäß den HTTP-Standards umschlossen. Dieses Feld unterstützt globale Variablen, Projektvariablen und Jitterbit-Variablen mit eckigen Klammern [ ].

• Benutzername und Passwort: Geben Sie die Anmeldeinformationen für den Zugriff auf das WSDL ein, falls erforderlich. Lassen Sie das Feld leer, wenn keine Authentifizierung benötigt wird.

  Standardmäßig verhandelt Harmony mit dem Endpunkt, 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 Basic
  • HTTP Digest
  • HTTP Digest mit Authentifizierung im IE-Stil

• Zertifikat: Wählen Sie ein Zertifikat aus, um sich beim HTTP-Server zu authentifizieren. Sie können clientseitige SSL-Zertifikate über die Management-Konsole unter Anpassungen > Client-Zertifikate verwalten.

• Wiederholen: Diese Einstellung ist nur in Umgebungen mit einer privaten Agentengruppe funktionsfähig. Sie wiederholt Anfragen, wenn ein SOAP-Endpunkt diese Statuscodes zurückgibt: 500, 501, 502, 503 oder 504.

  Private Agenten müssen Version 10.29 oder höher sein, 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 an, wie lange (maximal 5 Sekunden) zwischen den Wiederholungsversuchen gewartet werden soll.

  • Maximale Wiederholungen: Geben Sie an, wie oft (maximal 5) die Anfrage wiederholt werden soll. Wenn die Anfrage nach allen Wiederholungen weiterhin fehlschlägt, erscheint eine Ausnahme im Betriebsprotokoll. Der private Agent protokolliert auch jede Wiederholung in der Datei jitterbit.log.

    Alle Wiederholungen zählen als Teil des gleichen Betriebsdurchlaufs, mit einem einzelnen Eintrag im Betriebsprotokoll. Alle Betriebsaktionen für nachgelagerte Operationen werden basierend auf dem endgültigen Status nach allen Wiederholungen 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 gesetzt sind.

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

  Hinweis

  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, die jede ausgewählte Methode zeigt, die als Aktivitätsblock unter der SOAP-Verbindung im Komponentenpalette gerendert wird. Um einen Anzeigenamen zu bearbeiten, klicken Sie auf das Bearbeitungssymbol und geben Sie einen neuen Namen ein.

  Hinweis

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

• Test: Klicken Sie, um die Verbindung mit der bereitgestellten Konfiguration zu überprüfen.

• Änderungen speichern: Klicken Sie, um die Konfiguration der Verbindung zu speichern und zu schließen.

• Änderungen verwerfen: Nachdem Sie Änderungen an einer neuen oder bestehenden Konfiguration vorgenommen haben, klicken Sie, um die Konfiguration ohne Speichern zu schließen. Eine Nachricht fragt Sie, ob Sie die Änderungen verwerfen möchten.

• Löschen: Nachdem Sie eine bestehende Verbindungs-Konfiguration geöffnet haben, klicken Sie, um die Verbindung dauerhaft aus dem Projekt zu löschen und die Konfiguration zu schließen (siehe Komponentenabhängigkeiten, Löschung und Entfernung). Eine Nachricht fragt Sie, ob Sie die Verbindung löschen möchten.

Ersetzen eines hochgeladenen WSDL

Beim Ersetzen eines WSDL durch das Hochladen eines WSDL mit demselben Namen müssen die WSDL-Operationen denselben Namen haben wie alle, die derzeit von bestehenden Aktivitäten verwendet werden. Wenn sie nicht denselben Namen haben oder wenn in Verwendung befindliche WSDL-Operationen im Ersatz-WSDL fehlen, weist die folgende Fehlermeldung an, diese Aktivitäten zuerst zu löschen, und listet auf, welche Aktivitäten gelöscht werden müssen:

• Aktivitäten, die gelöscht werden müssen
  Aktivität 1

• Nicht definierte WSDL-Operationen, die von diesen Aktivitäten verwendet werden
  Operation 1

Nach der Löschung listet die folgende Bestätigungsnachricht Aktivitäten auf, die möglicherweise von der Ersetzung der WSDL betroffen sind, um angrenzende Transformationen auf mögliche Mapping-Fehler zu überprüfen. Nach Bestätigung der Nachricht wird die WSDL an allen Stellen ersetzt, an denen sie im gesamten Projekt verwendet wird:

• Aktivitäten, die betroffen sein könnten
  Aktivität 1

• Definierte WSDL-Operationen, die von diesen Aktivitäten verwendet werden
  Operation 1

Fehlersuche

Ein Fehler ist bekannt, der bei SOAP-Verbindungen auftritt:

Wenn Sie einen ähnlichen Fehler wie oben erhalten, kann das erneute Hochladen der WSDL das Problem lösen.

Wenn Sie mehrere WSDLs hochgeladen haben, können Sie herausfinden, welche das Problem hat, indem Sie die folgenden Schritte ausführen:

1. Exportieren Sie das Projekt als JSON-Datei.

2. Öffnen Sie die JSON-Datei in einem Texteditor.

3. Suchen Sie nach dem Locator ohne die .wsdl-Endung. Zum Beispiel:

   0a12b345-6c7d-8e9f-0ghi-1jkl23m4567n
   

4. Der Treffer erscheint in einem Objekt mit einem wsdlDocumentId-Schlüssel:

   "wsdlDocumentId": "0a12b345-6c7d-8e9f-0ghi-1jkl23m4567n"
   

5. Finden Sie in der Nähe identifizierende Informationen zum Endpunkt in einem endpoint-configuration-Block oder in Feldern wie label, name, portName usw. Sie können auch die mit der WSDL verbundenen Operationsnamen (importAccount, importInventory usw.) sehen, um zu bestätigen, um welchen Endpunkt es sich handelt.

   Vorsicht

   Das Feld duplicateRef kann in Exporten als Duplikationsverlauffeld (nicht als WSDL-Identifikator) erscheinen und kann auf nicht verwandte Komponenten (Skripte/Transformationen) verweisen.

Um die WSDL erneut hochzuladen:

1. Öffnen Sie den SOAP-Endpunkt-Konfigurationsbildschirm.

2. Importieren Sie die WSDL erneut über die Optionen URL hochladen oder Datei hochladen. Wählen Sie nicht Vorhandenes auswählen.

3. Überprüfen Sie die Konfiguration des SOAP-Endpunkts. Möglicherweise müssen Sie den SOAP-Port und die Methoden erneut auswählen. Klicken Sie dann auf Änderungen speichern.

4. Überprüfen Sie die Konfiguration aller SOAP-Aktivitäten, die den SOAP-Endpunkt verwenden, um seine Schemata neu zu generieren.

5. Aktualisieren Sie die Konfiguration aller nachgelagerten Transformationen für Mapping-Änderungen.

Wir empfehlen, die WSDL mit dem Fehler zu löschen, nachdem alle abhängigen Aktivitäten entfernt wurden.

Nächste Schritte

Menüaktionen für eine Verbindung und deren Aktivitätstypen sind im Projektbereich und in der Designkomponenten-Palette zugänglich. Für Details siehe Aktionsmenüs in Connector-Grundlagen.

Nachdem Sie eine SOAP-Verbindung konfiguriert haben, können Sie eine oder mehrere SOAP-Aktivitäten konfigurieren, die mit dieser Verbindung verknüpft sind, um entweder als Quelle zu dienen, die Daten für eine Operation bereitstellt, oder als Ziel, um Daten in einer Operation zu konsumieren, oder Sie können die SOAP-Verbindung in einem Skript verwenden.

Für weitere Informationen siehe SOAP-Aktivitäten.