Zum Inhalt springen

SOAP -Aktivitäten

Einführung

Eine SOAP Aktivität ruft Daten von einem SOAP-Endpunkt ab oder sendet Daten an einen SOAP Endpoint und soll entweder als Quelle zum Bereitstellen von Daten für einen Operation oder als Ziel zum Verwenden von Daten in einem Operation verwendet werden. Die spezifischen verfügbaren Aktivitäten hängen von den SOAP Methoden ab, die während der Konfiguration der SOAP -Verbindung ausgewählt wurden. Sie können für jede SOAP -Verbindung beliebig viele SOAP -Aktivitäten konfigurieren.

Ob die Aktivität als Quelle oder Ziel in einer Operation verwendet werden kann, hängt vom jeweiligen Webdienst und den Anforderungs- und Antwortstrukturen (sofern vorhanden) ab. Weitere Informationen dazu, was bestimmt, ob eine Aktivität als Quelle oder Ziel verwendet werden kann, finden Sie unter Teile einer Operation in Operationserstellung und -konfiguration.

Erstellen einer SOAP Aktivität

Aus einer Verbindung wird mithilfe eines Aktivitätstyps eine Instanz einer Aktivität erstellt.

Um eine Instanz einer Aktivität zu erstellen, ziehen Sie den Aktivitätstyp auf die Design-Canvas oder kopieren Sie den Aktivitätstyp und fügen Sie ihn auf der Design-Canvas ein. Weitere Informationen finden Sie unter Erstellen einer Aktivitätsinstanz in Komponentenwiederverwendung.

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

Konfigurieren einer SOAP Aktivität

Führen Sie die folgenden Schritte aus, um eine SOAP Aktivität zu konfigurieren:

Schritt 1: Geben Sie einen Namen ein

SOAP Aktivität 1

  • Name: Geben Sie einen Namen ein, der zur Identifizierung der SOAP Aktivität verwendet werden soll. Dieses Feld ist bereits mit dem Namen der Methode ausgefü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 enthalten (/) oder Doppelpunkte (:).
  • Speichern und beenden: Klicken Sie, wenn aktiviert, 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 mit dem nächsten Schritt fortzufahren. Die Konfiguration wird erst gespeichert, wenn Sie im letzten Schritt auf die Schaltfläche Fertig klicken.
  • Änderungen verwerfen: Klicken Sie nach dem Vornehmen von Änderungen, um die Konfiguration zu schließen, ohne die an einem Schritt vorgenommenen Änderungen zu speichern. Sie werden in einer Meldung aufgefordert, zu bestätigen, dass Sie die Änderungen verwerfen möchten.

Schritt 2: Überprüfen der Datenschemata

SOAP Aktivität 2

  • Datenschema: Es werden die Datenschemata der Anfrage und/oder Antwort angezeigt. Wenn die Operation eine Transformation verwendet, werden die Datenschemata später während der Transformation erneut angezeigt-Prozess, bei dem Sie mithilfe von Quellobjekten, Scripts, Variablen, benutzerdefinierten Werten und mehr Zielfelder zuordnen können.

  • Plugin(s) hinzufügen: Plugins sind von Jitterbit oder vom Benutzer bereitgestellte Anwendungen, die die nativen Funktionen von Harmony erweitern. Um ein Plugin auf die Aktivität anzuwenden, klicken Sie, um diesen Abschnitt zu erweitern, und aktivieren Sie das Kontrollkästchen neben dem zu verwendenden Plugin. Weitere Anweisungen zur Verwendung von Plugins, einschließlich Details zum Festlegen aller erforderlichen Variablen, die vom Plugin verwendet werden, finden Sie unter Zu einer Aktivität hinzugefügte Plugins.

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

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

  • Änderungen verwerfen: Klicken Sie nach dem Vornehmen von Änderungen hier, um die Konfiguration zu schließen, ohne die an einem Schritt vorgenommenen Änderungen zu speichern. In einer Meldung werden Sie aufgefordert, zu bestätigen, dass Sie die Änderungen verwerfen möchten.

Nächste Schritte

Nachdem Sie eine SOAP Aktivität konfiguriert haben, können Sie sie wie unten beschrieben in einem Operation verwenden. Möglicherweise möchten Sie auch die chunking konfigurieren, um die Daten zur Verarbeitung in kleinere Chunks aufzuteilen. Ein spezieller Anwendungsfall zum Umgang mit SOAP Diensten, die keine Anforderungsparameter erfordern, wird ebenfalls unten behandelt.

Schließen Sie den Operation ab

Nachdem Sie eine SOAP Aktivität konfiguriert haben, schließen Sie die Konfiguration der Operation ab, indem Sie weitere Aktivitäten, Transformations oder Scripts als Operation hinzufügen und konfigurieren. Sie können auch die Operation einer Operation konfigurieren, die die Möglichkeit umfassen, Operationen zu verketten, die sich im gleichen oder in unterschiedlichen Workflows befinden.

Sobald eine SOAP Aktivität erstellt wurde, sind Menüaktionen für diese Aktivität über den Projektbereich entweder auf den Registerkarten Workflows oder Komponenten sowie über die Design-Canvas zugänglich. Siehe Aktionsmenü für weitere Einzelheiten.

Bei Vorgängen, die SOAP Aktivitäten verwenden, können auch Operation so konfiguriert werden, dass sie bei einem SOAP Fehler ausgelöst werden - einem Fehler, der durch ein falsches Nachrichtenformat, eine falsche Header-Verarbeitung oder eine Inkompatibilität verursacht wird. Vorgangsaktionen können so konfiguriert werden, dass nach Auftreten eines SOAP -Fehlers eine Operation Durchführen oder eine Email gesendet wird. Anweisungen zum Auslösen einer Aktion bei einem SOAP Fehler finden Sie unter Vorgangsaktionen.

Vorgänge, die eine SOAP Aktivität enthalten, können nur eine SOAP Aktivität haben und dürfen nicht gleichzeitig NetSuite enthalten, Salesforce, Salesforce Service Cloud, SAP oder ServiceMax Aktivitäten.

Wenn Sie bereit sind, führen Sie den Operation aus und validieren Sie das Verhalten, indem Sie die Operation überprüfen.

Als Quelle verwendet

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

Andere Muster sind bei der Verwendung von SOAP -Aktivitäten, die als Quelle dienen, nicht gültig.

Als Ziel verwendet

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

Andere Muster sind bei der Verwendung von SOAP -Aktivitäten, die als Ziel verwendet werden, nicht gültig.

Normalerweise enthält eine Operation, die einen SOAP Webdienst aufruft, zwei Transformations: Die erste transformiert Daten in eine Webdienstanforderung und die zweite transformiert Daten aus einer Webdienstantwort in ein Zielsystem. In diesem Beispiel wird eine SOAP Aktivität im Zwei-Transformations-Muster verwendet. Bei dieser Operation erstellt eine API Anforderungsaktivität (Anforderung) eine Anforderungsstruktur, die von der ersten Transformation (API zu SOAP) empfangen und an eine SOAP Aktivität (Kreditkarte überprüfen) übergeben wird. Die zweite Transformation (SOAP zu Dateifreigabe) empfängt die Antwortstruktur, die dann von einer Dateifreigabe-Schreibaktivität (Antwort schreiben) in eine Dateifreigabe geschrieben wird:

SOAP Operation 1

Verwenden von chunking

Viele Webdienst-APIs unterliegen Größenbeschränkungen. Wenn Sie an die von der API vorgegebenen Datensatzbeschränkungen stoßen, können Sie die Quelldaten mithilfe von chunking in mehrere Chunks aufteilen. Die Transformation wird dann für jeden Chunk separat durchgeführt, wobei jeder Quellchunk einen Zielchunk erzeugt. Die resultierenden Zielchunks werden kombiniert, um das endgültige Ziel zu erzeugen.

Anweisungen und Best Practices zur Verwendung von chunking finden Sie unter Operationsoptionen.

Verwenden eines SOAP Dienstes ohne Anforderungsparameter

SOAP Webdienste werden häufig als erstes Ziel im Transformation mit zwei Zielen_ verwendet: Eine Quelle stellt die Anforderung bereit, die der SOAP Webdienst als Eingabe verwendet, und der Dienst gibt dann eine Antwort aus, die in ein anderes Ziel geschrieben wird.

Bei manchen SOAP Webdiensten ist in der Anforderung jedoch möglicherweise nichts weiter erforderlich als die bloße Anforderung des Dienstes. In diesem Fall erfordert das Muster zwar immer noch zwei Transformations, die Anforderungsstruktur enthält jedoch möglicherweise keine Felder, die zugeordnet werden müssen. Stattdessen besteht die Struktur möglicherweise nur aus Knoten ohne Felder.

Dieser Operation verwendet die GetHolidaysAvailable Methode (in der SOAP Aktivität Get Holidays), die keine Anforderungsparameter erfordert:

SOAP Operation 2

Bei der Transformation FTP nach SOAP können wir sehen, dass alle Knoten erweitert sind und keine Felder vorhanden sind:

SOAP Operation 3

Das Ergebnis ist eine leere Transformation ohne Zuordnungen, die für die Gültigkeit der Operation erforderlich sind.