SOAP

Zweck

Der generische SOAP Connector ermöglicht die universelle Interaktion mit jedem Webservice, der das SOAP-Protokoll verwendet. Er ist nicht an eine bestimmte Anwendung gebunden, sondern lässt sich dynamisch konfigurieren, um mit jedem SOAP-Endpunkt zu kommunizieren, indem die WSDL-Datei (Web Services Description Language) des Dienstes bereitgestellt wird.

Der Fokus liegt auf der Automatisierung und dem Datenaustausch mit Unternehmenssystemen, Altsystemen und anderen Diensten, die keine REST- oder moderne API-Standards nutzen.

Praktische Anwendungshinweise

• Dynamisches Laden von Funktionen: Nach Eingabe einer gültigen WSDL-URL kann mit der Aktion „Anfragen abrufen“ das Dropdown-Menü „Anfrage“ mit allen verfügbaren SOAP-Funktionen des Webservices befüllt werden.

• Manuelle Authentifizierung: Die Authentifizierung wird manuell konfiguriert. Es ist erforderlich, den SOAP-Header mit korrektem Namen, Namespace und Datenstruktur gemäß den Anforderungen des Zielservices selbst zu definieren.

Debugging: Das rohe XML der letzten gesendeten Anfrage (rawRequest) und der letzten empfangenen Antwort (rawResponse) steht zur Verfügung und unterstützt so das Debugging komplexer SOAP-Interaktionen.

- Anfrage-Manipulation: Für spezielle Anwendungsfälle kann die rohe XML-Anfrage vor dem Versand über eine „Suchen und Ersetzen“-Funktionalität modifiziert werden (z. B. zum Entfernen bestimmter Attribute). - Antwort-Struktur: Bestimmte Felder in der SOAP-Antwort können so konfiguriert werden, dass sie immer als Array behandelt werden – auch wenn nur ein oder kein Element zurückgegeben wird. Das erhöht die Stabilität und Vorhersagbarkeit der Workflows.

Authentifizierung

Die Authentifizierung erfolgt durch die manuelle Definition des SOAP-Headers, was Flexibilität für verschiedenste Sicherheitsanforderungen bietet.

• WSDL: URL zur WSDL-Datei des SOAP-Dienstes – die Grundlage für alle Operationen.

• Authentication: JSON-Feld zur Definition des Authentifizierungsheaders:

  • Header name: Name des SOAP-Header-Stammelements (z. B. AuthHeader).

  • Header namespace: XML-Namespace des Headers.

  • Header data: JSON-Objekt, das in die XML-Struktur der Header-Daten umgewandelt wird.

Erwartungen an Ein- und Ausgabe

Eingabe

• Request: Auswahl aus einer Dropdown-Liste der SOAP-Funktionen, die aus der WSDL ermittelt wurden.

• Data: JSON-Objekt mit den Parametern, die an die ausgewählte SOAP-Funktion übergeben werden. Die Struktur muss der vom Webservice erwarteten Struktur entsprechen.

• Options: Optionales Feld zur Angabe erweiterter PHP-SoapClient-Optionen (z. B. SOAP-Version, Komprimierung).

Ausgabe

• response: Umgewandelter Body der SOAP-Antwort als JSON-Objekt.

• header: SOAP-Antwort-Header.

• rawRequest: Vollständiges XML der letzten gesendeten SOAP-Anfrage.

• rawResponse: Vollständiges rohes XML der letzten empfangenen SOAP-Antwort.

• createResponseDataStructure: Hilfsaktion zur einfachen Zuordnung von Feldern aus der response für nachfolgende Workflow-Schritte.