Webservices voor dataverwerking

Webservice-aanroepen in datamapping

Naast oproepen naar de Shopify/GraphQL API'sMapForce ondersteunt het direct aanroepen van SOAP- en REST-webservices binnen een mapping. U kunt een webservice-aanroep in een mapping toevoegen en invoerparameters, gebruikersnaam/wachtwoord of andere authenticatiemethoden opgeven. U kunt uitvoercomponenten verbinden met de webservice om het resultaat door te geven aan een andere component of om het op te slaan in een bestand.

MapForce ondersteunt ook generieke HTTP-webservices die doorgaans aangepaste aanvraag- of antwoordstructuren in de berichtinhoud bevatten. MapForce ondersteunt zowel JSON- als XML-gegevens in de aanvraag- of antwoordinhoud, waardoor u vrijwel elke HTTP-webservice kunt aanroepen die XML- of JSON-structuren vereist of retourneert.

De handmatige definitie van instellingen in het dialoogvenster voor het definiëren van web service aanroepen stelt ontwikkelaars in staat om instellingen te definiëren op basis van een sjabloon-URL. Dit is een handige stap wanneer ontwikkelaars web service aanroepen testen en verfijnen in een webbrowser, omdat ze de URL van de browser kunnen kopiëren en als sjabloon kunnen gebruiken.

Bent u op zoek naar een concreet voorbeeld? Hier is een gedetailleerde handleiding over: Integratie van gegevens via webdiensten.

MapForce ondersteunt authenticatie op basis van de WS-Security (Web Services Security) standaard, via clientcertificaten en het aanroepen van webdiensten via HTTPS. De parameters die nodig zijn om een veilige communicatie tot stand te brengen, worden gedefinieerd als onderdeel van de datamapping, waardoor de uitvoering automatisch verloopt.

OAuth 2.0 is een open standaard voor autorisatie die een manier biedt om clientapplicaties beveiligde, gedelegeerde toegang te geven tot webresources, waarbij gebruik wordt gemaakt van toegangstokens in plaats van wachtwoorden. MapForce biedt ondersteuning voor het aanroepen van webdiensten die OAuth 2.0-autorisatie vereisen.

Dit is mogelijk via de Credential Manager (die geopend wordt door met de rechtermuisknop te klikken in een actief mapping-project). OAuth-autorisatiedetails kunnen met behulp van credential-objecten worden overgedragen naar andere uitvoeromgevingen, zoals MapForce Server en FlowForce Server.

Importeer OpenAPI-definities

Het configureren van een REST-webservice-aanroep vereist het opgeven van details, waaronder de URL van de webservice, een aanvraagmethode (bijvoorbeeld GET, POST, PUT), de structuur van de aanvraag en het antwoord (bijvoorbeeld XML, JSON, aangepaste MIME-types) en de parameters. U kunt deze informatie handmatig toevoegen, door een WADL-bestand of een URL op te geven die de details bevat, of door een OpenAPI-definitie te importeren.

De OpenAPI Specificatie (OAS) is een gestandaardiseerd formaat voor het definiëren en beschrijven van RESTful API's. Het biedt een taal-onafhankelijke manier om de structuur, eindpunten, aanvraag- en antwoordformaten, parameters, authenticatiemethoden en andere aspecten van een API te beschrijven.

Wanneer u het OpenAPI-bestand specificeert dat de webdienst beschrijft die u nodig heeft, verwerkt MapForce automatisch de structuur van de aanvraag en toont deze als een grafische component voor data-mapping. Hierdoor is er geen handmatige configuratie meer nodig, wat het integratieproces met webdiensten aanzienlijk vereenvoudigt.