XML valideren in werkstromen met Azure Logic Apps

  • Artikel

Van toepassing op: Azure Logic Apps (verbruik + standaard)

In B2B-scenario's (business-to-business) voor enterprise-integratie moeten de handelspartners in een overeenkomst er vaak voor zorgen dat de berichten die ze uitwisselen geldig zijn voordat de gegevensverwerking kan worden gestart. De werkstroom van de logische app kan XML-berichten en -documenten valideren met behulp van de actie XML-validatie en een vooraf gedefinieerd schema.

Als u geen gebruik hebt van logische apps, raadpleegt u Wat is Azure Logic Apps? Zie Werkstromen voor B2B-bedrijfsintegratie met Azure Logic Apps en Enterprise Integration Pack voor meer informatie over B2B Enterprise-integratie.

Vereisten

  • Een Azure-account en -abonnement. Als u nog geen abonnement hebt, meldt u zich aan voor een gratis Azure-account.

  • De werkstroom van de logische app, leeg of bestaand, waarin u de actie XML-validatie wilt gebruiken.

    Als u een lege werkstroom hebt, gebruikt u de gewenste trigger. In dit voorbeeld wordt de aanvraagtrigger gebruikt.

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

    • Bevindt zich op dezelfde locatie of Azure-regio als uw logische app-resource waar u de actie XML-validatie* wilt gebruiken.

    • Als u het resourcetype Logische app (verbruik) gebruikt, vereist uw integratieaccount de volgende items:

    • Als u het resourcetype Logische app (Standaard) gebruikt, slaat u geen schema's op in uw integratieaccount. In plaats daarvan kunt u rechtstreeks schema's toevoegen aan de resource van uw logische app met behulp van de Azure Portal of Visual Studio Code. U kunt deze schema's vervolgens gebruiken in meerdere 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. U hoeft uw logische app-resource echter niet te koppelen aan uw integratieaccount, dus de koppelingsmogelijkheid bestaat niet. Uw integratieaccount moet nog steeds voldoen aan andere vereisten, zoals het gebruik van hetzelfde Azure-abonnement en het bestaande op dezelfde locatie als uw logische app-resource.

      Notitie

      Op dit moment ondersteunt alleen het resourcetype Logische app (verbruik)RosettaNet-bewerkingen . Het resourcetype Logische app (Standard) bevat geen RosettaNet-bewerkingen .

XML-validatieactie toevoegen

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

  2. Als u een lege logische app hebt die geen trigger heeft, voegt u de gewenste trigger toe. In dit voorbeeld wordt de aanvraagtrigger gebruikt. Anders gaat u verder met de volgende stap.

    Als u de aanvraagtrigger wilt toevoegen, typt HTTP requestu in het zoekvak van de ontwerper en selecteert u de aanvraagtrigger met de naam Wanneer een HTTP-aanvraag wordt ontvangen.

  3. Kies onder de stap in uw werkstroom waaraan u de actie XML-validatie wilt toevoegen een van de volgende stappen:

    Kies een stap voor een logische app op basis van verbruik of ISE-plan:

    • Als u de actie XML-validatie aan het einde van uw werkstroom wilt toevoegen, selecteert u Nieuwe stap.

    • Als u de actie XML-validatie tussen bestaande stappen wilt toevoegen, beweegt u de aanwijzer over de pijl die deze stappen verbindt, zodat het plusteken (+) wordt weergegeven. Selecteer dat plusteken en selecteer vervolgens Een actie toevoegen.

    Kies een stap voor een logische app op basis van een standard-plan:

    • Als u de actie XML-validatie aan het einde van uw werkstroom wilt toevoegen, selecteert u het plusteken (+) en selecteert u vervolgens Een actie toevoegen.

    • Als u de actie XML-validatie tussen bestaande stappen wilt toevoegen, selecteert u het plusteken (+) dat tussen deze stappen wordt weergegeven en selecteert u vervolgens Een actie toevoegen.

  4. Selecteer onder Kies een actie de optie Ingebouwd. Typ xml validation in het zoekvak. Selecteer XML-validatie in de lijst met acties.

  5. Als u de XML-inhoud voor validatie wilt opgeven, klikt u in het vak Inhoud zodat de lijst met dynamische inhoud wordt weergegeven.

    De lijst met dynamische inhoud bevat eigenschapstokens die de uitvoer van de vorige stappen in de werkstroom vertegenwoordigen. Als in de lijst geen verwachte eigenschap wordt weergegeven, controleert u de trigger- of actiekop in de lijst en of u Meer weergeven kunt selecteren.

    Voor een logische app op basis van verbruik of ISE-plan ziet de ontwerpfunctie er als volgt uit:

    Schermopname van de ontwerpfunctie voor meerdere tenants met geopende lijst met dynamische inhoud, de cursor in het vak Inhoud en de geopende lijst met dynamische inhoud.

    Voor een logische app op basis van een standard-plan ziet de ontwerpfunctie er als volgt uit:

    Schermopname van de ontwerpfunctie voor één tenant met geopende lijst met dynamische inhoud, de cursor in het vak Inhoud en de geopende lijst met dynamische inhoud

  6. Selecteer in de lijst met dynamische inhoud het eigenschapstoken voor de inhoud die u wilt valideren.

    In dit voorbeeld wordt het token Body van de trigger geselecteerd.

  7. Als u het schema wilt opgeven dat moet worden gebruikt voor validatie, opent u de lijst Schemanaam en selecteert u het schema dat u eerder hebt toegevoegd.

  8. Wanneer u klaar bent, moet u de werkstroom van de logische app opslaan.

    U bent nu klaar met het instellen van de xml-validatieactie . In een echte app wilt u de gevalideerde gegevens mogelijk opslaan in een LOB-app (Line-Of-Business), zoals SalesForce. Als u de gevalideerde uitvoer naar Salesforce wilt verzenden, voegt u een Salesforce-actie toe.

  9. Als u de validatieactie wilt testen, activeert en voert u de werkstroom uit. Verzend bijvoorbeeld voor de aanvraagtrigger een aanvraag naar de eindpunt-URL van de trigger.

    De actie XML-validatie wordt uitgevoerd nadat uw werkstroom is geactiveerd en wanneer XML-inhoud beschikbaar is voor validatie.

Volgende stappen