Zum Inhalt springen

Verwandeln Sie Ihre Kontakte in Urlaubsgeld mit unserem neuen Kundenempfehlungsprogramm! Erfahren Sie mehr

✕

API SOAP Antwortaktivität

Einführung

Eine API SOAP Response-Aktivität, die ihre vorkonfigurierte API Verbindung verwendet, gibt Daten an eine benutzerdefinierte API-Manager API zurück und soll als Ziel zum Verbrauchen von Daten in einer Operation verwendet werden.

Die API Aktivität SOAP-Antwort kann nur mit einem WSDL- Schema konfiguriert werden. Um mit einer API -Verbindung über ein JSON-, XML-, CSV- oder XSD Schema zu interagieren, verwenden Sie eine Nicht-SOAP Aktivität API -Antwort stattdessen. Um mit einer SOAP -Verbindung zu interagieren, ohne eine benutzerdefinierte API zu verwenden, verwenden Sie den SOAP Connector.

Informationen zur Beziehung zwischen API Connector-Aktivitäten und API-Manager APIs finden Sie in diesen Ressourcen:

Erstellen einer API SOAP -Antwortaktivität

Eine Instanz einer API SOAP Response-Aktivität wird aus der vorkonfigurierten API Verbindung erstellt mithilfe des Aktivitätstyps SOAP Antwort.

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 Sie eine Aktivität oder Tool-Instanz in Komponentenwiederverwendung.

Eine vorhandene API SOAP-Antwort-Aktivität kann an diesen Stellen bearbeitet werden:

Konfigurieren einer API SOAP -Antwortaktivität

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

Schritt 1: Namen eingeben und Einstellungen festlegen

Geben Sie in diesem Schritt einen Namen für die Aktivität an und wählen Sie die Methode aus, die zum Hochladen des WSDL- Schema verwendet werden soll. Jedes Benutzeroberflächenelement dieses Schritts wird unten beschrieben.

API SOAP Antwort-Aktivitätskonfigurationsschritt 1

  • Name: Geben Sie einen Namen zur Identifizierung der Aktivität ein. Der Name muss für jede API SOAP Response-Aktivität eindeutig sein und darf keine Schrägstriche enthalten. /oder Doppelpunkte :.

  • URL hochladen, Datei hochladen oder Vorhandene auswählen: Wählen Sie mit dem Optionsfeld die Quelle der WSDL-Datei (Web Services Description Language) aus, 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 Mögliche Fehler weiter unten auf dieser Seite.

    • Datei hochladen: Verwenden Sie die Schaltfläche Durchsuchen rechts, um lokal 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 Mögliche Fehler 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:

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

      Sie würden 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.

    • Vorhandene auswählen: Verwenden Sie die Dropdown-Liste, 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.

  • 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.

  • Operation: Verwenden Sie die Dropdown-Liste, um die Methode aus der bereitgestellten WSDL auszuwählen, die Sie mit dieser Aktivität ausführen möchten.

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

  • Weiter: Klicken Sie hier, 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 hierauf, 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

Alle vom Endpoint generierten Anforderungs- oder Antwortschemata werden angezeigt:

API SOAP Antwort-Aktivitätskonfigurationsschritt 2

  • Datenschemata: Die Anforderungs- und Antwortschemata für diese Aktivität werden angezeigt. Diese Datenschemata werden von benachbarten Transformations übernommen und während der Transformation erneut angezeigt..

    Notiz

    Die in einer Transformation bereitgestellten Daten haben Vorrang vor der Aktivitätskonfiguration.

  • 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, 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 hierauf, 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.

Mögliche Fehler

Die folgenden Abschnitte behandeln Fehler, die während der Aktivitätskonfiguration auftreten können.

WSDL kann nicht hochgeladen werden

Wenn Sie eine WSDL ersetzen, indem Sie mithilfe von Upload URL oder Upload-Datei eine WSDL mit demselben Namen erneut hochladen, und die Vorgänge der Ersatz-WSDL nicht dieselben Namen haben wie die von vorhandenen Aktivitäten verwendeten, oder wenn verwendete WSDL-Vorgänge in der Ersatz-WSDL fehlen, kann dieser Fehler auftreten:

This WSDL cannot be replaced because it is missing WSDL operations that are use by existing activities. Delete these activities from the project pane's Components tab and try again.

Um das Problem zu beheben, stellen Sie sicher, dass die WSDL-Operationen dieselben Namen haben wie die Operationen, die aktuell von vorhandenen Aktivitäten verwendet werden.

Einsetzen fehlgeschlagen

Beim Bereitstellen eines Operation, dessen WSDL-Datei der SOAP Anforderung-Aktivität ersetzt wurde, erhalten Sie möglicherweise diesen Fehler:

Failed to deploy - Client Error: There is no uploaded file with client path ... Upgrade to the 8.4.0 Studio or higher and deploy the project again.

Um das Problem zu beheben, führen Sie die folgenden Schritte aus:

  1. Öffnen Sie die Aktivität, in der die WSDL-Datei ersetzt wurde.

  2. Bei Schritt 1, wählen Sie die für die Aktivität zu verwendende WSDL-Datei erneut aus und klicken Sie dann auf Weiter.

  3. Bei Schritt 2, klicken Sie auf Fertig.

  4. Führen Sie die Operation durch.

Nächste Schritte

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

Auf Menüaktionen für eine Aktivität kann über den Projektbereich und die Design-Canvas zugegriffen werden. Weitere Informationen finden Sie unter Aktionsmenü in Connector-Grundlagen.

API SOAP Response-Aktivitäten können als Ziel mit diesen Operation verwendet werden:

Wenn Sie bereit sind, einsetzen den Operation und validieren Sie das Verhalten durch Überprüfen der Operation.

Wichtig

Standardmäßig werden erfolgreiche Vorgänge, die für eine benutzerdefinierte API konfiguriert sind, sind nicht in den Operation enthalten, sofern nicht eine dieser Einstellungen aktiviert ist:

  • Cloud-Agenten: Für API Operationen auf einem Cloud-Agenten Operation debuggen muss für die Operation aktiviert sein.
  • Private Agenten: Für API Operationen auf einem privaten Agenten muss entweder Operation debuggen muss für die Operation aktiviert sein oder Sie müssen EnableLogging=true im [APIoperation] Abschnitt der privaten Agentenkonfigurationsdatei.

Nicht erfolgreiche Vorgänge werden in die Operation aufgenommen, ob die oben genannten Einstellungen aktiviert sind oder nicht.

Konfigurieren einer benutzerdefinierten API-Manager API

Sobald der Operation konfiguriert und bereitgestellt ist, konfigurieren Sie eine benutzerdefinierte API mit API-Manager.

Notiz

Nachdem Sie eine benutzerdefinierte API zum Aufrufen konfiguriert haben an Integration Studio Operation, können Sie die Operation nicht löschen, ohne entweder die API zu löschen oder die Konfiguration der API so zu ändern, dass die Operation nicht mehr aufgerufen wird.