Webservices
MapForce unterstützt WSDL-basierte und Nicht-WSDL Webservices. Zu den Nicht-WSDL Webservices gehört die große Kategorie der generischen HTTP APIs, die oft auch als REST- oder RESTful APIs bezeichnet werden. Auch die Shopify API und generische GraphQL APIs werden von MapForce unterstützt.
WSDL-basierte Webservices
Bei einem WSDL-basierten Webservice werden die Operationen, Input- und Output-Nachrichten und die Netzwerkdetails des Service anhand einer WSDL (Web Services Description Language)-Datei beschrieben. WSDL-Dateien sind XML-basiert und verwenden normalerweise das SOAP-Protokoll, in dem definiert ist, wie der Nachrichtenaustausch zwischen einem Client und einem Service erfolgt.
Außerdem können Sie in MapForce SOAP-Webservice-Projekte erstellen und Java- oder C#-Code zur Implementierung von SOAP-Webservices generieren. Des Weiteren können Sie einen SOAP-Webservice aufrufen und die Antwortdaten in jedem von MapForce unterstützen Format ausgeben. Wenn in der WSDL-Datei mehrere Services, Endpoints und Operationen implementiert sind, können Sie diese direkt in MapForce auswählen oder aktualisieren.
Protokolle von WSDL-basierten Services
Bei Auswahl eines WSDL-basierten Webservice können Sie die folgenden Protokolle verwenden:
•SOAP 1.1, 1.2 über HTTP: Es wird sowohl der Stil RPC/Encoded als auch der Stil Document/Literal unterstützt. Wenn der Webserver einen WSDL-Fehler zurückgibt, wird die Ausführung des Mappings gestoppt. In solchen Fällen können Sie optional eine Ausnahmekomponente für die Fehlerbehandlung in den Mapping-Bereich einfügen. Wenn der Webservice einen nicht-WSDL-Fehler zurückgibt, wird die Mapping-Ausführung gestoppt und eine Fehlermeldung zurückgegeben (oder auf dem Bildschirm angezeigt, wenn Sie eine Mapping-Vorschau in MapForce anzeigen).
•Nicht-SOAP über HTTP: Dies bezieht sich auf weniger gebräuchliche Nicht-SOAP HTTP-Services. Bei HTTP GET wird der Stil url-encoded unterstützt. Bei HTTP POST werden die Stile url-encoded und text/xml unterstützt.
HTTP APIs
HTTP APIs enthalten normalerweise in ihrem Message Body-Teil Request- oder Response-Strukturen. MapForce unterstützt die folgenden Arten von Request- oder Response-Bodies: JSON, XML, Protocol Buffers und unstrukturierte Bodys mit benutzerdefinierten MIME Types.
Bei HTTP APIs können die Webservice-Informationen manuell oder automatisch eingegeben werden. Dazu gehören die URL, eine Request-Methode (z.B. GET, POST, PUT), die Request- und Response-Struktur (wie z.B. XML, JSON oder benutzerdefinierte MIME-Types) sowie Parameter.
XML und JSON
Sie können für Ihre Request/Response-Strukturen JSON-, XML- oder DTD-Schemas verwenden. MapForce akzeptiert auch eine XML-Datei mit einer gültigen Schemareferenz. Außerdem kann die Webservice-Definition auch aus einer WADL-Datei importiert werden. Sie können diese anschließend manuell adaptieren. Beachten Sie jedoch, dass WADL keine Standardmethode zum Definieren von JSON-Strukturen, sondern nur zum Definieren von XML-Strukturen bietet.
Wenn Sie eine XML- oder JSON-Beispielinstanzdatei, nicht aber die Schema-Datei haben, können Sie das Schema mit XMLSpy erstellen (https://www.altova.com/de/xmlspy.html). Falls nötig, kann XMLSpy Ihre Instanzdatei auch von XML in JSON konvertieren oder umgekehrt.
Protocol Buffer
Im Fall von Protocol Buffers Requests und Responses benötigen Sie eine .proto-Datei, die die Protocol Buffers-Binärdatei beschreibt. In diesem Szenario kann der Body des Webservice von oder auf eine Protocol Buffers-Komponente gemappt werden. Nähere Informationen dazu finden Sie unter: Beispiel: Auslesen von Daten aus Protol Buffers und Beispiel: Schreiben von Daten in Protocol Buffers.
Nicht strukturierte Bodys mit benutzerdefinierten MIME-Types
Sie können auch Webservices aufrufen, bei denen die Request- oder Response-Struktur flexibel und nicht an ein bestimmtes Schema gebunden ist. Sie können für solche Fälle die vordefinierten MapForce mime-Funktionen verwenden, um entweder den an einen Webservice gesendeten Raw Message Body (die MIME Entity) zu erstellen oder die vom Webservice retournierte MIME Entity zu verarbeiten.
Shopify API und generische GraphQL APIs
Sie können in MapForce die Shopify API oder eine generische GraphQL API aufrufen.
GraphQL ist eine Abfragesprache für APIs. Shopify ist eine E-Commerce-Plattform, über die Unternehmen Online-Shops erstellen und verwalten, Produkte verkaufen, Bestellungen, Kunden, Zahlungen und Versand verwalten können. Entwickler können Shop-Daten über die Shopify API programmatisch aufrufen und damit interagieren und verschiedene Prozesse automatisieren. Die Shopifiy API unterstützt für die Interaktion mit den Shop-Daten GraphQL.
Nähere Informationen dazu finden Sie unter Shopify API und GraphQL API. Näheres darüber, wie Sie GraphQL-Abfragen und Mutationen erstellen, finden Sie unter Beispiele.
Beispiele
Beispiele für Mappings mit Webservice-Aufrufen finden Sie in den folgenden Kapiteln:
•Beispiel: Aufruf einer HTTP API
•Beispiel: Mappen von Daten von einem RSS Feed
•Beispiel: Aufrufen eines SOAP-Webservice
•Beispiel: OAuth 2.0-Autorisierung