Zum Inhalt springen

SOAP-Aktivitäten

Einführung

Eine SOAP-Aktivität, die ihre SOAP-Verbindung verwendet, ruft Daten von einem SOAP-Endpunkt ab oder sendet Daten an einen SOAP-Endpunkt und ist dafür gedacht, entweder als Quelle zur Bereitstellung von Daten für eine Operation oder als Ziel zum Konsumieren von Daten in einer Operation verwendet zu werden. Die spezifischen Aktivitäten, die verfügbar sind, hängen von den während der Konfiguration der SOAP-Verbindung ausgewählten SOAP-Methoden ab. Sie können so viele SOAP-Aktivitäten für jede SOAP-Verbindung konfigurieren, wie Sie möchten.

Ob die Aktivität als Quelle oder Ziel in einer Operation verwendet werden kann, hängt vom spezifischen Webdienst und den vorhandenen Anfrage- und Antwortstrukturen ab. Für weitere Informationen darüber, was bestimmt, ob eine Aktivität als Quelle oder Ziel verwendet werden kann, siehe Teile einer Operation in Erstellung und Konfiguration von Operationen.

Erstellen einer SOAP-Aktivität

Eine Instanz einer SOAP-Aktivität wird aus einer Verbindung unter Verwendung eines Aktivitätstyps erstellt.

Um eine Instanz einer Aktivität zu erstellen, ziehen Sie den Aktivitätstyp auf die Entwurfsfläche oder kopieren Sie den Aktivitätstyp und fügen Sie ihn auf der Entwurfsfläche ein. Für Details siehe Erstellen einer Aktivitäts- oder Toolinstanz in Komponentenwiederverwendung.

Eine vorhandene Aktivität kann von diesen Orten aus bearbeitet werden:

Konfigurieren einer SOAP-Aktivität

Befolgen Sie diese Schritte, um eine SOAP-Aktivität zu konfigurieren:

Schritt 1: Geben Sie einen Namen ein

  • Endpoint-Menü: Wenn Sie mehrere Endpunkte des gleichen Verbindungstyps konfiguriert haben, wird ein Menü oben auf dem Bildschirm mit dem aktuellen Endpunktnamen angezeigt. Klicken Sie auf das Menü, um zu einem anderen Endpunkt zu wechseln. Weitere Informationen finden Sie unter Ändern des zugewiesenen Endpunkts in Konfigurationsbildschirmen.

    • Endpunkt bearbeiten: Wird angezeigt, wenn Sie über den aktuellen Endpunktnamen fahren. Klicken Sie, um die Verbindungs-Konfiguration des aktuell ausgewählten Endpunkts zu bearbeiten.

  • Name: Geben Sie einen Namen ein, um die SOAP-Aktivität zu identifizieren. Dieses Feld ist mit dem Namen der Methode vorausgefüllt. Sie können mehrere Aktivitäten mit derselben Methode erstellen, aber der Name muss für jede SOAP-Aktivität eindeutig sein und darf keine Schrägstriche (/) oder Doppelpunkte (:) enthalten.

  • Speichern & Beenden: Wenn aktiviert, klicken Sie, um die Konfiguration für diesen Schritt zu speichern und die Aktivitätskonfiguration zu schließen.

  • Weiter: Klicken Sie, um die Konfiguration für diesen Schritt vorübergehend zu speichern und zum nächsten Schritt fortzufahren. Die Konfiguration wird nicht gespeichert, bis Sie die Schaltfläche Fertig im letzten Schritt klicken.

  • Änderungen verwerfen: Nachdem Sie Änderungen vorgenommen haben, klicken Sie, um die Konfiguration zu schließen, ohne die vorgenommenen Änderungen zu speichern. Eine Nachricht fragt Sie, ob Sie die Änderungen wirklich verwerfen möchten.

Schritt 2: Überprüfen Sie die Datenschemas

  • Datenschema: Die Anforderungs- und/oder Antwortdatenschemas werden angezeigt. Wenn die Operation eine Transformation verwendet, werden die Datenschemas später während des Transformations-Mappings erneut angezeigt, wo Sie Ziel-Felder mit Quellobjekten, Skripten, Variablen, benutzerdefinierten Werten und mehr zuordnen können.

  • Plugin(s) hinzufügen: Plugins sind von Jitterbit oder Benutzern bereitgestellte Anwendungen, die die nativen Fähigkeiten von Harmony erweitern. Um ein Plugin auf die Aktivität anzuwenden, klicken Sie, um diesen Abschnitt zu erweitern, und wählen Sie das Kontrollkästchen neben dem zu verwendenden Plugin aus. Für zusätzliche Anweisungen zur Verwendung von Plugins, einschließlich Details zur Festlegung erforderlicher Variablen, die vom Plugin verwendet werden, siehe Plugins, die zu einer Aktivität hinzugefügt wurden.

  • Zurück: Klicken Sie, um die Konfiguration für diesen Schritt vorübergehend zu speichern und zum vorherigen Schritt zurückzukehren.

  • Fertig: Klicken Sie, um die Konfiguration für alle Schritte zu speichern und die Aktivitätskonfiguration zu schließen.

  • Änderungen verwerfen: Nach Änderungen klicken Sie, um die Konfiguration zu schließen, ohne die vorgenommenen Änderungen zu speichern. Eine Nachricht fragt Sie, ob Sie die Änderungen wirklich verwerfen möchten.

Nächste Schritte

Nachdem Sie eine SOAP-Aktivität konfiguriert haben, können Sie sie innerhalb einer Operation wie unten beschrieben verwenden. Möglicherweise möchten Sie auch Chunking konfigurieren, um die Daten in kleinere Teile zum Verarbeiten aufzuteilen.

Operation abschließen

Nachdem Sie eine SOAP-Aktivität konfiguriert haben, schließen Sie die Konfiguration der Operation ab, indem Sie andere Aktivitäten oder Tools als Operation Schritte hinzufügen und konfigurieren. Sie können auch die Betriebseinstellungen konfigurieren, die die Möglichkeit umfassen, Operationen zu verketten, die sich in denselben oder unterschiedlichen Workflows befinden.

Menüaktionen für eine Aktivität sind im Projektbereich und auf der Entwurfsgrafik zugänglich. Für Details siehe Aktivitätsaktionsmenü in Connector-Grundlagen.

Operationen, die SOAP-Aktivitäten verwenden, können auch Betriebsaktionen konfiguriert haben, die bei einem SOAP-Fehler ausgelöst werden — einem Fehler, der aus einem falschen Nachrichtenformat, der Verarbeitung von Headern oder Inkompatibilität resultiert. Betriebsaktionen können so konfiguriert werden, dass sie eine Operation ausführen oder eine Email senden, nachdem ein SOAP-Fehler aufgetreten ist. Für Anweisungen zum Auslösen einer Aktion bei einem SOAP-Fehler siehe Betriebsaktionen.

Operationen, die eine SOAP-Aktivität enthalten, können nur eine SOAP-Aktivität haben und dürfen keine NetSuite, Salesforce, Salesforce Service Cloud, SAP oder ServiceMax Aktivitäten enthalten.

Wenn Sie bereit sind, deployen und ausführen Sie die Operation und validieren Sie das Verhalten, indem Sie die Betriebsprotokolle überprüfen.

Als Quelle verwendet

SOAP-Aktivitäten, die als Quelle verwendet werden, können mit diesen Betriebsmustern verwendet werden:

Andere Muster sind ungültig, wenn SOAP-Aktivitäten als Quelle verwendet werden.

Als Ziel verwendet

SOAP-Aktivitäten, die als Ziel verwendet werden, können mit diesen Betriebsmustern verwendet werden:

Andere Muster sind mit SOAP-Aktivitäten, die als Ziel verwendet werden, nicht gültig.

Verwenden Sie einen SOAP-Dienst ohne Anforderungsparameter

SOAP-Webdienste werden häufig als erstes Ziel im Zwei-Transformation-Muster verwendet: Eine Quelle liefert die Anfrage, die der SOAP-Webdienst als Eingabe verwendet, und der Dienst gibt dann eine Antwort aus, die in ein anderes Ziel geschrieben wird.

Einige SOAP-Webdienste benötigen jedoch möglicherweise nichts weiter in der Anfrage, als nur nach dem Dienst zu fragen. In diesem Fall sind zwar weiterhin zwei Transformationen durch das Muster erforderlich, aber die Anforderungsstruktur könnte keine Felder enthalten, die eine Zuordnung erfordern; stattdessen könnte die Struktur nur aus Knoten ohne Felder bestehen.

Fehlersuche

Wenn während der Konfiguration von SOAP-Aktivitäten Fehler auftreten, sollten Sie in Betracht ziehen, Chunking oder einen alternativen XML-Parser je nach Ihrer Implementierung zu verwenden.

Verwenden Sie Chunking

Viele Webdienst-APIs haben Größenbeschränkungen. Wenn Sie auf Aufzeichnungsgrenzen stoßen, die von der API auferlegt werden, möchten Sie möglicherweise Chunking verwenden, um die Quelldaten in mehrere Teile zu unterteilen. Die Transformation wird dann für jedes Chunk separat durchgeführt, wobei jedes Quell-Chunk ein Ziel-Chunk erzeugt. Die resultierenden Ziel-Chunks kombinieren sich, um das endgültige Ziel zu erzeugen.

Für Anweisungen und bewährte Verfahren zur Verwendung von Chunking siehe Betriebsoptionen.

Verwenden Sie einen alternativen XML-Parser

Beim Arbeiten mit SOAP-Aktivitäten, die ein XML-Schema verwenden, können Sie eine alternative XML-Parser-Implementierung aktivieren, um Probleme mit XML-Namensräumen und XML-Knoten in Transformationen zu lösen. Setzen Sie die jitterbit.transformation.jbxmlparser Variable vor der Transformation:

$jitterbit.transformation.jbxmlparser = true;

Der alternative Parser verwendet weniger Speicher, wenn er große XML-Quelldateien in Transformationen verarbeitet, die nicht für Streaming-Transformationen qualifiziert sind.