Lobster_data kann Daten mittels HTTP-Protokoll empfangen. Zusätzlich sollen nun die Daten mittels SOAP-XML (über HTTP) an ein Profil durchgereicht werden und der Aufrufer möchte zudem den Aufbau der zu sendenden Daten mittels WSDL-Datei ermitteln.

Legen Sie ein neues Profil Act_As_Web_Service an und wählen sie den event-gesteuerten Eingangsagenten des Typs HTTP(S) aus.

images/download/attachments/69043962/835-version-1-modificationdate-1650970634617-api-v2.png

(1) Tragen Sie hier z. B. /meinWebService ein.

(2) Setzen Sie diese beiden Checkboxen.

Quellstruktur erstellen

images/download/attachments/69043962/833-version-1-modificationdate-1650969088492-api-v2.png

Damit ein Profil als Webservice-Methode richtig funktioniert, muss natürlich die Quellstruktur vorhanden sein. Die Dokumentenart muss zudem XML sein, da wir ja SOAP-XML Nachrichten verarbeiten wollen.

Die Quellstruktur basiert auf folgender XML-Datei. Siehe auch Abschnitt XML to XSD (to Structure).

<?xml version="1.0" encoding="UTF-8"?>
<Daten>
	<Artikel name="Jacke" gruppe="Bekleidung">
		<Nummer ean="4711">123</Nummer>
		<Beschreibung>Wasserdicht</Beschreibung>
	</Artikel>
</Daten>

Wenn wir nun noch ein 1:1-Mapping erzeugen und das Profil abspeichern, sind wir fast fertig.

Webservice aufrufen

Öffnen Sie einen Web-Browser und geben Sie Ihre konfigurierte URL ein. Sollten Sie nichts anderes in der Konfigurationsdatei ./etc/startup.xml und im Profil eingetragen haben, lautet die URL http://<Adresse_Ihres_Integration_Servers>/dw/Request/meinWebService (Groß/Kleinschreibung beachten!).

Es erscheint folgende Fehler-Nachricht.

Your request could not be processed due to unknown/mismatched parameters

Diese Fehlermeldung ist soweit in Ordnung, denn wir haben ja auch keine Daten (mit Parametern) gesendet. Aber es ist bereits ein Teilerfolg.

WSDL-Datei

Nun aber das Ganze für die Anzeige der WSDL-Datei. Hängen Sie einfach hinter die URL noch ein ?wsdl an, also http://<Adresse_Ihres_Integration_Servers>/dw/Request/meinWebService?wsdl.

Die WSDL-Datei wird automatisch von Lobster_data erstellt.

...

Knoten und Felder bei WSDL-Erzeugung aus Quellstruktur ignorieren

Wenn bestimmte Knoten oder Felder bei der automatischen Erzeugung der WSDL-Datei aus der Quellstruktur ignoriert werden sollen, können Sie das erreichen indem Sie den Wert _exclude_ in der Knoten-Eigenschaft bzw. Feld-Eigenschaft Portalsteuerung angeben.

Service-Namen in der WSDL-Datei vorgeben

Per Default wird der Servicename in der WSDL-Datei immer ProfileService genannt. Möchten Sie den Namen selbst bestimmen, können Sie hierzu in den Feldern für Strukturnamen (siehe Screenshot) den Namen vorgeben. In diesem Fall muss der Strukturname mit Service: beginnen. Hier also Service:MyServiceIn und Service:MyServiceOut.

Zielstruktur und WSDL

Wird die WSDL-Datei auf Basis der Zielstruktur erstellt, dann wird zusätzlich zur Quellstruktur auch die Zielstruktur des Profils herangezogen. Für die Erzeugung der Elementdefinition wird folgendermaßen vorgegangen.

Er wird der Name des Feldes/Knoten in der Zielstruktur (ohne _val oder _attr) oder die Beschreibung des Feldes/Knoten genommen, wenn diese vorhanden ist. Dadurch ist es möglich Elemente mit gleichen Namen innerhalb der Definition zu verwenden, was in der Zielstruktur nicht möglich ist. Steht in der Beschreibung eines Knotens die Zeichenkette _exclude_, dann wird dieser Knoten in der WSDL-Erzeugung übersprungen.

Eindeutige Root-Elementnamen verwenden

Bei der Erzeugung der WSDL-Datei auf Basis der Zielstruktur wird davon ausgegangen, dass die XML-Root-Elemente in der erzeugten Request- und Response-Struktur eindeutig sind. Die XML-Namen werden in der Quellstruktur aus den Satzartkennungen der Knoten/Felder und in der Zielstruktur aus den Namen der Knoten und Felder, bzw. den in der Feldbeschreibung definierten Knotennamen generiert. Deshalb sollten die Root-Knoten von Quell- und Zielstruktur nicht gleich sein. Falls gleiche Namen unvermeidbar sind, kann die dynamische WSDL-Erzeugung nicht verwendet werden. Dann kann nur die Bereitstellung der WSDL-Datei, wie im Abschnitt Statische WSDL-Erzeugung beschrieben, angewendet werden. Diese WSDL-Datei muss in der Regel manuell erzeugt bzw. nachbearbeitet werden.

Statische WSDL-Erzeugung

Alternativ zur dynamischen Erzeugung der WSDL-Datei kann man unter ./conf/wsdl/<URL-Adressen-Suffix>.wsdl die WSDL-Datei hinterlegen. Das Zeichen / muss dann im Dateinamen durch ein _ ersetzt werden. Die Datei wird unter diesem Pfadnamen gesucht und anstelle der dynamischen WSDL-Erzeugung verwendet, wenn die Datei gefunden wird, lesbar ist und nicht leer. In der Datei kann man den Bereich der Rückantwort, der bei WSDL-Anfragen mit eingebettet wird, entsprechend anpassen.

Webservice-Aufruf ohne Fehler

Wie kann man das nun testen? Siehe dazu Abschnitt Mit Profil Webservice aufrufen im Eingangsagenten.