Zum Hauptinhalt springen

SOAP-Aufruf

Aktuelle Konfiguration des Tasks SOAP-Aufruf im Workflow Designer
  • Aufgabentyp: soap-call

Beschreibung​

Die Aufgabe "SOAP-Aufruf" ermöglicht es, eine Anfrage an einen Webdienst basierend auf dem SOAP-Protokoll zu senden. Die Aufgabe erstellt automatisch den XML-Inhalt (Envelope) und parst die vom Server zurückgegebenen Fehlermeldungen (Fault).

Konfigurationsparameter​

  • SSL-Verbindung: Gibt an, ob der Aufruf das SSL-Protokoll verwenden soll (si / no).
  • Proxy: Konfiguration für die Weiterleitung des Aufrufs:
  • Systemeinstellung: Verwendet die voreingestellten Proxy-Einstellungen des Systems.
  • Kein Proxy: Kein Proxy verwendet.
  • Benutzerdefinierter Proxy: Ermöglicht die Eingabe einer bestimmten Adresse in das dafür vorgesehene Feld.
  • Endpoint: Die vollständige URL des zu fragenden SOAP-Webdienstes. (z.B. https://www.dataaccess.com/webservicesserver/NumberConversion.wso).
  • Namespace: Die XML-Namespace-URI, die dem Präfix ns innerhalb des Anforderungstextes zugeordnet werden soll. Geben Sie die gesamte Deklaration ein, einschließlich xmlns:ns= und des Namespace in Anführungszeichen. (z.B. xmlns:ns="http://www.dataaccess.com/webservicesserver/").
  • Header: Fügen Sie das Tag <soap:Header> in die SOAP-Nachricht ein. Wenn keine Daten einzufügen sind, verwenden Sie <soap:Header/>. Wenn der Dienst Informationen erfordert (z.B. ein Autorisierungstoken), fügen Sie diese innerhalb des Tags ein:
<soap:Header>
 <auth:Token>ABC123XYZ</auth:Token>
</soap:Header>```
  • Body: Fügen Sie das Tag <soap:Body> mit den Anforderungsdaten ein (z.B. <soap:Body><ns:Metodo>...</ns:Metodo></soap:Body>).

Wichtige technische Hinweise​

  • Envelope: Das Tag </soap:Envelope> darf nicht eingefügt werden. Die Aufgabe generiert den XML-Header sowie das Öffnen/Schließen des Envelopes automatisch.
  • Content-Type: Die Aufgabe verwendet ausschließlich text/xml; charset=utf-8 als Standard-Content-Type und ist nicht änderbar.

Ausgabeparameter​

Die Aufgabe gibt nach Erhalt der Antwort vom Server die folgenden Parameter aus:

  • result: Gibt eine Textnachricht zurück, die das Ergebnis der Operation beschreibt.
  • response: Enthält das gesamte Antwort-XML, das vom Server im Erfolgsfall gesendet wurde.
  • faultCode: Gibt den SOAP-Fehlercode zurück (z.B. soap:Server oder soap:Client), falls der Aufruf fehlschlägt.
  • faultString: Gibt die textuelle Fehlerbeschreibung zurück, die vom Webdienst bereitgestellt wird.
  • exitStatus: Statuscode der Operation (0 deutet auf Erfolg hin).
  • resultJson: Vollständige Darstellung der Ausführung der Aufgabe im JSON-Format.

Beispiel resultJson​

{
  "run_info": {
    "status": "Completed",
    "run_result": "Success"
  },
  "output_parameters": {
    "exitStatus": "0"
  }
}

Fehlerbehandlung​

Bei einem SOAP-Fehler (Vorhandensein eines Knotens <soap:Fault>) wird die Aufgabe als Fehlgeschlagen markiert. Die Details des Fehlers werden in den Parametern faultCode und faultString abgebildet, was das Debugging oder die Verwaltung von bedingten Verzweigungen im Workflow erleichtert.