XML opstellen 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 moet u mogelijk XML-documenten maken op basis van JSON-gegevens. Uw werkstroom voor logische apps kan XML-documenten opstellen met behulp van de actie XML opstellen met schema, waarvoor een XSD-schema is vereist.

Stel dat u JSON-gegevens van Azure Service Bus ontvangt en die gegevens in XML-indeling naar een FTP-server moet verzenden. U kunt de JSON-gegevens gebruiken als inhoud voor de XML opstellen met schemaactie en een nieuw XML-document maken met de brongegevens. U kunt deze XML-gegevens vervolgens verzenden naar de FTP-server.

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 Opstellen-XML met schemaactie kunt toevoegen aan uw werkstroom.

• 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 waar u de XML opstellen-XML wilt gebruiken met schemaactie .

  • 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 opstellen 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 opstellen met schemaactie toevoegen

1. Open in Azure Portal uw standaard logische app en werkstroom in de ontwerpfunctie.

2. 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.

3. Volg onder de stap in uw werkstroom waar u de XML opstellen met schemaactie wilt toevoegen deze algemene stappen om de actie XML opstellen met schema toe te voegen.

4. Selecteer in de lijst Bron de locatie waar u uw XSD-schema hebt geüpload, ofwel uw LogicApp-resource of uw IntegrationAccount.

5. Selecteer uw XSD-schema in de lijst Naam .

   Nadat u het schema hebt geselecteerd, worden onder de lijst Naam de JSON-invoerparameters van het schema voor het hoofdelement dynamisch weergegeven.

6. Voer de waarden voor elk element in.

   1. Als u uitvoer van eerdere bewerkingen in de werkstroom wilt selecteren, selecteert u in de sectie JSON-schema voor element Root de optie in een kenmerkvak en selecteert u vervolgens de optie voor de lijst met dynamische inhoud (bliksempictogram).

   2. Selecteer in de lijst met dynamische inhoud het token voor de inhoud die u voor elk kenmerk wilt opstellen.

      

7. Voor een kenmerk dat een matrix accepteert, kunt u Overschakelen naar de hele matrix selecteren, die alleen wordt weergegeven voor matrixparameters.

   

8. Sla uw werkstroom op als u gereed bent.

   U bent nu klaar met het instellen van de XML opstellen 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 samengestelde uitvoer naar Salesforce wilt verzenden, voegt u een Salesforce-actie toe.

9. Als u uw opstellende actie 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 opstellen met schemaactie wordt uitgevoerd nadat uw werkstroom is geactiveerd en wanneer JSON-inhoud beschikbaar is voor het opstellen van XML-gegevens.

Geavanceerde parameters

In de volgende tabel worden de geavanceerde parameters beschreven die beschikbaar zijn in deze actie:

Parameter	Weergegeven als	Beschrijving
Gekwalificeerde naam van hoofdknooppunt	<root-node-qualified-name>	De gekwalificeerde naam van het hoofdknooppunt voor het geval het schema meerdere definitie-elementen bevat.
Datum en tijd	<datum-tijdnotatie>	De datum- en tijdnotatieaanduiding, bijvoorbeeld 'dddd, MMM dd jjjj uu:mm:ss: zzz'.
XML Writer-instellingen laten XML-declaratie weg	Nee of Ja	Of u een XML-declaratie weglaat.
Nieuwe regel voor XML Writer-instellingen voor kenmerken	Nee of Ja	Of u kenmerken op een nieuwe regel wilt schrijven.
Nieuwe regelafhandeling voor XML Writer-instellingen	- Entitize - Geen - Replace	Geef op hoe regeleinden moeten worden verwerkt.
Nieuwe regeltekens voor XML Writer-instellingen	<new-line-string>	De tekenreeks die moet worden gebruikt voor regeleinden.
Tekens laten inspringen door XML Writer-instellingen	<inspringingstekens>	De tekenreeks die moet worden gebruikt voor inspringing.
Inspringing van XML Writer-instellingen	Nee of Ja	Of u elementen wilt laten inspringen.
Codering van XML Writer-instellingen	Er zijn verschillende opties beschikbaar.	Het type tekstcodering dat moet worden gebruikt.
XML Writer-instellingen ontsnappen niet aan URI-kenmerken	Nee of Ja	Of u geen URI-kenmerken wilt ontsnappen.
Conformanceniveau van XML Writer-instellingen	- Auto - Document - Fragment	Het nalevingsniveau dat moet worden gebruikt voor de XML-schrijver om DE XML-uitvoer te controleren.
XML Writer-tekens controleren	Nee of Ja	Of u ervoor wilt zorgen dat alle tekens in het document voldoen aan de XML-specificatie.
JSON-schema voor element Root. Xmlns	<json-schema-root>	De XML-naamruimte die moet worden gebruikt voor het declareren van een naamruimte voor elementen in een XML-document.
JSON-schema voor element Root. UserDetails Xmlns	<json-schema-root>	De XML-naamruimte die moet worden gebruikt voor het declareren van een naamruimte voor elementen in een XML-document.
JSON-schema voor element Root. Status-XMLN's	<json-schema-root>	De XML-naamruimte die moet worden gebruikt voor het declareren van een naamruimte voor elementen in een XML-document.

Gerelateerde inhoud

• XML parseren met schema