Webservices zur Datenverarbeitung

Webservice-Aufrufe in Datenmappings

Zusätzlich zum Aufruf von Shopify/GraphQL APIs unterstützt MapForce den Aufruf von SOAP- und REST-Webservices direkt von einem Mapping aus. Sie können einen Webservice-Aufruf in ein Mapping einfügen und Input-Parameter sowie Benutzername/Passwort oder eine andere Authentizierung definieren. Um das Ergebnis an eine andere Komponente zu übergeben oder es in eine Datei zu schreiben, verbinden Sie die Output-Parameter mit dem Webservice.

MapForce unterstützt auch generische HTTP-Webservices, die normalerweise im Message Body benutzerdefinierte Request- oder Response-Strukturen übertragen. MapForce unterstützt sowohl JSON- als auch XML-Daten im Request oder Response Body, sodass Sie praktisch jeden HTTP-Webservice, in dem XML- oder JSON-Strukturen verwendet werden, aufrufen können.

Die Einstellungen können auf Basis einer Vorlagen-URL vorgenommen werden. Dies ist ein hilfreicher Schritt, wenn Sie Webservice-Aufrufe in einem Webbrowser-Fenster testen und anpassen möchten.

Sie hätten gerne ein konkretes Anwendungsbeispiel? Hier finden Sie eine ausführliche Anleitung zur Integration von Webservice-Daten.

MapForce unterstützt die Authentifizierung auf Basis des WS-Security-Standards mittels Client-Zertifikaten und durch Aufruf von Webservices über HTTPS. Die Parameter für die sichere Kommunikation werden im Rahmen des Datenmappings definiert, sodass die Ausführung automatisch erfolgt.

OAuth 2.0 ist ein offener Standard für die Autorisierung. Client Applikationen erhalten damit durch Zugriffs-Tokens anstelle von Passwörtern sicheren, delegierten Zugriff auf Webressourcen. MapForce bietet Unterstützung für den Aufruf von Webservices, für die eine OAuth 2.0-Autorisierung erforderlich ist.

Diese Funktion wird im Anmeldeinformationen-Manager (Aufruf durch Rechtsklick in ein aktives Mapping-Projekt) aktiviert. Die OAuth-Autorisierungsinformationen können mit Hilfe von Anmeldeinformationsobjekten auf andere Ausführungsumgebungen wie MapForce Server und Flowforce Server übertragen werden.

Import von OpenAPI-Definitionen

Um einen REST Webservice-Aufruf zu konfigurieren, müssen Informationen wie die Webservice URL, eine Request-Methode (z.B. GET, POST, PUT), die Request- und Response-Struktur (wie z.B. XML, JSON, benutzerdefinierte MIME-Types) sowie Parameter angegeben werden. Sie können diese Informationen manuell, durch Definition einer WADL-Datei oder einer URL, die die Informationen enthält, hinzufügen oder durch Import einer OpenAPI-Definition.

Die OpenAPI-Spezifikation (OAS) ist ein standardisiertes Format zur Definition und Beschreibung von RESTful APIs. Sie bietet eine Methode, um die Struktur, Endpoints, das Request- und Response-Format, die Parameter, Authentifizierungsmethoden und andere Aspekte einer API unabhängig von der verwendeten Sprache festzulegen.

Wenn Sie die OpenAPI-Datei, die den gewünschten Webservice beschreibt, definieren, verarbeitet MapForce die Struktur des Calls automatisch und zeigt sie in Form einer grafischen Datenmapping-Komponente an. Durch den Wegfall der manuellen Konfiguration lässt sich der Prozess der Integration mit Webservices erheblich effizienter gestalten.