XML parseren met behulp van schema's in standaardwerkstromen met Azure Logic Apps (preview)
Van toepassing op: Azure Logic Apps (Standard)
Belangrijk
Deze mogelijkheid is in preview en is onderworpen aan de aanvullende gebruiksvoorwaarden voor Microsoft Azure Previews.
In scenario's voor bedrijfsintegratie business-to-business (B2B) of BizTalk-migratie moet u mogelijk XML-documenten parseren. Uw werkstroom voor de logische app Standard kan XML parseren met behulp van de actie XML parseren met schema, waarvoor een XSD-schema is vereist.
Stel dat u regelmatig klantorders of facturen ontvangt die GEBRUIKMAKEN van XML als exchange-indeling en toegang nodig hebt tot afzonderlijke XML-elementen in de werkstroomontwerper voor Azure Logic Apps.
Beperkingen
Deze actie wordt momenteel nog niet ondersteund voor de resource en werkstroom van de logische app Verbruik.
Vereisten
Een Azure-account en -abonnement. Als u nog geen abonnement hebt, meldt u zich aan voor een gratis Azure-account.
Een standaardwerkstroom voor logische apps die al begint met een trigger, zodat u de XML parseren met schemaactie aan uw werkstroom kunt toevoegen.
Een integratieaccountresource waarin u artefacten definieert en opslaat, zoals handelspartners, overeenkomsten, certificaten, enzovoort, voor gebruik in uw bedrijfsintegratie en B2B-werkstromen. Deze resource moet voldoen aan de volgende vereisten:
Is gekoppeld aan hetzelfde Azure-abonnement als uw logische app-resource.
Bestaat in dezelfde locatie of Azure-regio als uw logische app-resource waarin u de XML parseren met schemaactie wilt gebruiken.
Als u aan een resource en werkstroom voor een standaard logische app werkt, kunt u uw integratieaccount koppelen aan de resource van uw logische app, XSD-schema's rechtstreeks uploaden naar de resource van uw logische app, of beide, op basis van de volgende scenario's:
Als u al een integratieaccount hebt met de artefacten die u nodig hebt of wilt gebruiken, kunt u uw integratieaccount koppelen aan meerdere resources van de logische standaard-app waar u de artefacten wilt gebruiken. Op die manier hoeft u GEEN XSD-schema's te uploaden naar elke afzonderlijke logische app. Zie Uw logische app-resource koppelen aan uw integratieaccount voor meer informatie.
Als u geen integratieaccount hebt of uw artefacten alleen wilt gebruiken voor meerdere werkstromen binnen dezelfde logische app-resource, kunt u rechtstreeks schema's toevoegen aan uw resource voor logische apps met behulp van Azure Portal of Visual Studio Code.
Als u dus geen integratieaccount hebt of nodig hebt, kunt u de optie uploaden gebruiken. Anders kunt u de koppelingsoptie gebruiken. In beide gevallen kunt u deze artefacten gebruiken voor alle onderliggende werkstromen binnen dezelfde logische app-resource.
U hebt nog steeds een integratieaccount nodig voor het opslaan van andere artefacten, zoals partners, overeenkomsten en certificaten, samen met het gebruik van de AS2-, X12- en EDIFACT-bewerkingen .
Het XSD-schema dat moet worden gebruikt met de XML parseren met schemaactie . Zorg ervoor dat dit schema een hoofdelement bevat, dat eruitziet als in het volgende voorbeeld:
<xs:element name="Root"> <....> </xs:element>
Een XML parseren met schemaactie toevoegen
Open in Azure Portal uw standaard logische app en werkstroom in de ontwerpfunctie.
Als u een lege werkstroom hebt die geen trigger heeft, volgt u deze algemene stappen om een gewenste trigger toe te voegen. Anders gaat u verder met de volgende stap.
In dit voorbeeld wordt de aanvraagtrigger gebruikt.
Volg onder de stap in uw werkstroom waar u de parserings-XML met schemaactiewilt toevoegen deze algemene stappen om de actie Parse XML met schema toe te voegen.
Geef in het vak Inhoud de XML-inhoud op die u wilt parseren met behulp van XML-gegevens die u in de HTTP-aanvraag ontvangt.
Als u uitvoer van eerdere bewerkingen in de werkstroom wilt selecteren, selecteert u in het vak Inhoud de XML parseren met schemaactie en selecteert u de optie voor de lijst met dynamische inhoud (bliksempictogram).
Selecteer in de lijst met dynamische inhoud het token voor de inhoud die u wilt parseren.
In dit voorbeeld wordt het bodytoken van de trigger geselecteerd.
Selecteer in de lijst Bron de locatie waar u uw XSD-schema hebt geüpload, ofwel uw LogicApp-resource of uw IntegrationAccount.
Selecteer uw XSD-schema in de lijst Naam .
Sla uw werkstroom op als u gereed bent.
U bent nu klaar met het instellen van uw XML parseren met schemaactie . In een echte app wilt u mogelijk de geparseerde gegevens opslaan in een LOB-app (Line-Of-Business), zoals Salesforce. Als u de geparseerde uitvoer naar Salesforce wilt verzenden, voegt u een Salesforce-actie toe.
Als u uw parseringsactie wilt testen, activeert u uw werkstroom en voert u deze uit. Voor de aanvraagtrigger verzendt u bijvoorbeeld een aanvraag naar de eindpunt-URL van de trigger.
De XML parseren met schemaactie wordt uitgevoerd nadat uw werkstroom is geactiveerd en wanneer XML-inhoud beschikbaar is voor parseren.
Geavanceerde parameters
In de volgende tabel worden de geavanceerde parameters beschreven die beschikbaar zijn in deze actie:
| Parameter | Weergegeven als | Beschrijving |
|---|---|---|
| DTD-verwerking |
-
Negeren - Parse - Verbieden |
Geef op hoe de definitie van het XML-documenttype (DTD) moet worden verwerkt. |
| XML normaliseren | Nee of Ja | Of xml-inhoud moet worden genormaliseerd. |
| Witruimte negeren? | Nee of Ja | Of u nu onbelangrijke witruimte wilt parseren of negeren, zoals spaties, tabbladen en lege regels in XML-documenten. |
| Xml-verwerkingsinstructies negeren? | Nee of Ja | Of u de XML-verwerkingsinstructies wilt volgen of negeren. |
| XML-kenmerken negeren | Nee of Ja | Of u XML-kenmerken wilt schrijven of negeren. |
| Volledig gekwalificeerde namen gebruiken? | Nee of Ja | Of u nu eenvoudigere lokale namen of volledig gekwalificeerde XML-namen wilt gebruiken. |
| Gekwalificeerde naam van hoofdknooppunt | < root-node-qualified-name> | De gekwalificeerde naam van het hoofdknooppunt voor het geval het schema meerdere definitie-elementen bevat. |