Delen via

B2B-berichten tussen handelspartners automatiseren met behulp van werkstromen in Azure Logic Apps

Van toepassing op: Azure Logic Apps (Verbruik + Standard)

Voor B2B-integraties (business-to-business) kunt u de communicatie tussen handelspartners automatiseren door werkstromen te bouwen met B2B-artefacten en industriestandaardprotocollen in Azure Logic Apps.

U kunt bijvoorbeeld een integratieaccount maken om artefacten zoals handelspartners, overeenkomsten, kaarten en schema's te definiëren. Werkstromen ondersteunen protocollen zoals AS2, X12, EDIFACT en RosettaNet. Maak end-to-end-integraties door deze B2B-mogelijkheden te combineren met meer dan 1400 connectors die beschikbaar zijn in Azure Logic Apps, zoals Office 365 Outlook, SQL Server en Salesforce.

In deze handleiding ziet u hoe u een voorbeeld van een B2B-werkstroom maakt waarmee de volgende taken kunnen worden uitgevoerd:

  • Ontvang HTTPS-aanvragen met de aanvraagtrigger met de naam Wanneer een HTTP-aanvraag wordt ontvangen.
  • Decodeer de inhoud van binnenkomende berichten met de AS2-decodeeractie (v2) en de X12-decodeeractie .
  • Retourneert een antwoord naar de beller met de actie Antwoord .

Vereisten

  • Een Azure-account en -abonnement. Ontvang een gratis Azure-account.

  • De resource van de logische app en de lege werkstroom waarin u in dit voorbeeld de B2B-integratie wilt bouwen.

    De AS2-bewerkingen (v2) en X12 bevatten geen triggers. Uw werkstroom kan beginnen met elke trigger of elke actie gebruiken om berichten te ontvangen.

    In de voorbeelden in dit artikel wordt de Request-trigger genaamd Wanneer een HTTP-aanvraag wordt ontvangen gebruikt.

    Voor meer informatie, zie:

  • Een integratieaccountresource voor het definiëren en opslaan van artefacten voor bedrijfsintegratie en B2B-werkstromen.

    • Zowel het integratieaccount als de resource van de logische app moeten zich in hetzelfde Azure-abonnement en dezelfde Azure-regio bevinden.

    • Definieert ten minste twee handelspartners in uw integratieaccount. De definities voor beide partners moeten dezelfde kwalificatie voor zakelijke identiteiten gebruiken, zoals AS2, X12, EDIFACT of RosettaNet.

    • Definieert een AS2-overeenkomst en X12-overeenkomst tussen de handelspartners die deelnemen aan uw werkstroom. Voor elke overeenkomst zijn een hostpartner en een gastpartner vereist.

      De inhoud in de berichten tussen de partners moet overeenkomen met het overeenkomsttype. Zie voor informatie over overeenkomstinstellingen die moeten worden gebruikt bij het ontvangen en verzenden van berichten:

  • Voordat u met de AS2- en X12-bewerkingen aan de slag gaat, moet u uw Consumption-logische app of standaard logische app koppelen aan het integratieaccount, zodat u kunt werken met artefacten zoals handelspartners en overeenkomsten. U kunt een integratieaccount koppelen aan meerdere Consumption- of Standaard-logische appresources om dezelfde artefacten te delen.

    Wanneer u de AS2- en X12-bewerkingen toevoegt, moet u mogelijk een verbinding maken met het integratieaccount:

    Werkstroom voor logische apps Verbinding vereist?
    Consumption - AS2-connector (v2): geen verbinding vereist

    - X12-connector: verbinding vereist
    Standaard - AS2-connector (v2): geen verbinding vereist

    - X12 ingebouwde connector: geen verbinding vereist

De aanvraagtrigger toevoegen

Als u de werkstroom in dit voorbeeld wilt starten, voegt u de aanvraagtrigger toe.

  1. Open uw logische app-resource in Azure Portal.

  2. Open uw werkstroom in de ontwerper. Volg deze algemene stappen om de ingebouwde trigger Aanvraag toe te voegen met de naam Wanneer een HTTP-aanvraag wordt ontvangen in uw werkstroom.

    Het deelvenster met triggerinformatie wordt geopend met het tabblad Parameters geselecteerd.

  3. Laat de JSON-schemaparameter van de aanvraagbody leeg omdat de trigger X12-berichten in platte bestandsindeling ontvangt.

    Schermopname met parameters voor Azure Portal, workflowontwerper en triggeraanvraag.

  4. Sla uw workflow op. Selecteer in de werkbalk van de ontwerper Opslaan.

    Met deze stap wordt de HTTP-URL gegenereerd, die u later gebruikt om een aanvraag te verzenden die de werkstroom activeert.

    De schermafbeelding toont de workflowontwerper, de aanvraagtriggerparameters, en de gegenereerde URL voor de aanvraagtrigger.

  5. Kopieer en sla de URL op voor later gebruik.

De as2-actie decoderen toevoegen

Volg deze stappen om de as2-decodeeractie (v2) toe te voegen.

  1. Voer onder de aanvraagtrigger de volgende algemene stappen uit om de volgende AS2-actie (v2) toe te voegen op basis van uw werkstroomtype:

    Werkproces Actienaam
    Consumption AS2 Decoderen
    Standaard AS2 decoderen

  2. Geef in de parameter Bericht om te decoderen van de actie de berichtinhoud op die moet worden gedecodeerd.

    In dit voorbeeld wordt de hoofdtekst opgegeven vanuit de uitvoer van de Request-trigger. U kunt deze inhoud opgeven door een expressie te selecteren in de lijst met dynamische inhoud of door een expressie in te voeren:

    • Volg deze stappen voor de lijst met dynamische inhoud om uitvoer uit eerdere bewerkingen te kiezen:

      1. Selecteer in het vak Bericht om te decoderen en selecteer vervolgens het bliksempictogram om de lijst met dynamische inhoud te openen.

      2. Onder Wanneer een HTTP-aanvraag wordt ontvangen, selecteer Hoofdtekst, bijvoorbeeld:

        Schermopname toont workflowontwerper, triggerparameters voor verzoeken, en lijst met dynamische inhoud waarbij de Body-parameter is geselecteerd.

        Notitie

        Als de hoofdtekst niet wordt weergegeven in de lijst met dynamische inhoud, selecteert u naast het sectielabel Wanneer een HTTP-aanvraag wordt ontvangen , de optie Meer informatie.

    • Als u een expressie wilt invoeren die verwijst naar de inhoud in de body eigenschap vanuit de uitvoer van de aanvraagtrigger , voert u de volgende stappen uit:

      1. Selecteer in het vak Bericht om te decoderen en selecteer vervolgens het functiepictogram om de expressie-editor te openen.

      2. Voer in het editorvak de volgende expressie in en selecteer Toevoegen:

        triggerOutputs()['body']

  3. Voer in de parameter Berichtkoppen van de actie eventuele headers in die nodig zijn voor de AS2-actie. U vindt deze waarden in de headers eigenschap uit de uitvoer van de aanvraagtrigger door de volgende stappen uit te voeren:

    1. Selecteer in de sectie Berichtkoppen de optie Berichtkoppen overschakelen naar de tekstmodus:

      Schermopname van de actie AS2-decoderen met Berichtkoppen naar tekstmodus schakelen geselecteerd.

    2. Selecteer in het vak Berichtkoppen en selecteer vervolgens het functiepictogram om de expressie-editor te openen.

    3. Voer in het editorvak de volgende expressie in en selecteer Toevoegen:

      triggerOutputs()['Headers']

      De schermafbeelding toont het veld Berichtkoppen met een uitdrukking die verwijst naar de kopteksten in de uitvoer van de trigger.

    4. Als u de expressie in het Headers token wilt omzetten, selecteert u de codeweergave op de werkbalk van de ontwerper en selecteert u Vervolgens Designer.

Ontvangstbevestiging bevestigen

Als u het ontvangstbewijs van het bericht wilt bevestigen, retourneert u een antwoord dat een MDN (AS2 Message Disposition Notification) bevat naar de afzender met behulp van de acties Voorwaarde en Antwoord .

Belangrijk

Zorg ervoor dat deze acties onmiddellijk volgen op de AS2-actie, zodat de werkstroom blijft doorgaan met het verwerken als de AS2-actie slaagt. Anders stopt de werkstroom met de verwerking als de AS2-actie mislukt.

Een voorwaardeactie toevoegen om het actiepad te kiezen

Met deze stappen voegt u de actie Voorwaarde toe, zodat u een of meer voorwaarden kunt opgeven om de acties te evalueren en te kiezen, op basis van of de AS2-decodeeractie (v2) slaagt.

  1. Voer in de ontwerpfunctie, onder de as2(v2) -decodeeractie, deze algemene stappen uit om de ingebouwde actie Voorwaarde toe te voegen.

    De actie Voorwaarde verschijnt met de lege paden Waar en Onwaar. Later voegt u de acties toe die in deze paden moeten worden uitgevoerd, op basis van of de voorwaarde waar of onwaar oplevert.

    Schermopname van de actie Voorwaarde met lege paden.

  2. Selecteer de titelbalk Voorwaarde om de actie uit te vouwen, zodat u een of meer voorwaarden kunt opgeven die u wilt evalueren.

  3. Voer aan de linkerkant een waardevak kiezen de volgende expressie in op basis van uw werkstroomtype:

    Verbruik

    @body('AS2_Decode')?['messageContent']?['isMdnExpected']

    Standaard

    @body('Decode_AS2')?['messageContent']?['isMdnExpected']

    Belangrijk

    Zorg ervoor dat de AS2-decoderingsactienaam en de uitvoernaam overeenkomen met de namen van de geselecteerde AS2-actie.

  4. Selecteer in de middelste lijst het gelijkteken (=).

  5. Voer in het vak Rechts een waarde kiezen de waarde Expectedin.

    Schermopname van de actie Voorwaarde met de voorbeeldvoorwaarde die moet worden geëvalueerd.

  6. Sla uw workflow op.

Actiepaden instellen

Deze stappen geven de acties op die moeten worden uitgevoerd en de antwoorden die moeten worden geretourneerd op basis van of de AS2-decodeeractie (v2) slaagt.

  1. Voer de volgende stappen uit als de as2-codeeractie (v2) slaagt:

    1. Selecteer in het vak True het plusteken (+) >Actie toevoegen.

    2. Voer in het zoekvak Een actie toevoegen in response. Selecteer onder Aanvraag de ingebouwde actie Antwoord .

    3. Als u wilt verwijzen naar de MDN van AS2 (v2) decodeeractieuitvoer, geeft u de volgende expressies op:

      • Voer in de parameter Headers van de actie voor de sleutelwaarde de volgende expressie in:

        Verbruik

        @body('AS2_Decode')?['outgoingMdnContent']?['outgoingMdnHeaders']

        Standaard

        @body('Decode_AS2')?['outgoingMdnContent']?['outgoingMdnHeaders']

      • Voer in de hoofdtekstparameter van de actie de volgende expressie in:

        Verbruik

        @body('AS2_Decode')?['outgoingMdnContent']?['messageContent']

        Standaard

        @body('Decode_AS2')?['outgoingMdnContent']?['messageContent']

      Belangrijk

      Zorg ervoor dat de AS2-decoderingsactie naam en uitvoernamen overeenkomen met de namen voor uw geselecteerde AS2-actie.

      In het volgende voorbeeld ziet u hoe de actie Antwoord eruitziet:

      Schermopname van antwoordactie en opgeloste expressies die toegang hebben tot de AS2 MDN.

  2. Voer de volgende stappen uit als de as2-decoderactie (v2) mislukt:

    1. Selecteer in het vak False het plusteken (+) >Een actie toevoegen.

    2. Voer in het zoekvak Een actie toevoegen in response. Selecteer onder Aanvraag de ingebouwde actie Antwoord .

    3. Stel de actie Antwoord in om de gewenste status en fout te retourneren.

  3. Sla uw workflow op.

De X12-berichtactie decoderen toevoegen

Volg deze stappen om X12-berichten te decoderen.

  1. Voer in de ontwerpfunctie onder de actie Antwoord de volgende algemene stappen uit om de volgende X12-decodeeractie toe te voegen op basis van uw werkstroomtype:

    Werkproces Actienaam
    Consumption X12-bericht decoderen
    Standaard X12 decoderen

    Zie Exchange X12-berichten in B2B-werkstromen met Azure Logic Apps voor meer informatie.

  2. Als de actie u vraagt om een verbinding te maken, geeft u de volgende informatie op en selecteert u Nieuwe maken.

    • Verbindingsnaam
    • Id van integratieaccount
    • SAS-URL van integratieaccount

    Zie X12-berichten decoderen voor meer informatie.

  3. Geef in het deelvenster actiegegevens de inhoud op voor de actie die moet worden gedecodeerd op basis van uw werkstroomtype:

    Werkproces Actienaam Parameternaam
    Consumption X12-bericht decoderen X12-bericht met plat bestand om te decoderen
    Standaard X12 decoderen Bericht om te decoderen

    In dit voorbeeld wordt de berichtinhoud uit de uitvoer van de AS2-actie (v2) gebruikt. Deze uitvoer maakt echter gebruik van de JSON-objectindeling en is base64 gecodeerd. U moet de inhoud converteren naar een tekenreeks.

    Als u de inhoud wilt converteren, voert u de volgende expressie in het vak bericht-naar-decode in op basis van uw werkstroomtype:

    Verbruik

    @base64ToString(body('AS2_Decode')?['messageContent'])

    Standaard

    @base64ToString(body('Decode_AS2')?['messageContent'])

    Belangrijk

    Zorg ervoor dat de AS2-decoderingsactie naam en uitvoernamen overeenkomen met de namen voor uw geselecteerde AS2-actie.

  4. Sla uw workflow op.

  5. Als u de expressie wilt omzetten in een token, schakelt u tussen de codeweergave en de ontwerpweergave. Selecteer op de werkbalk van de ontwerper de codeweergave en selecteer vervolgens Designer.

U bent nu klaar met het instellen van deze B2B-voorbeeldwerkstroom. In een echte app wilt u mogelijk de gedecodeerde X12-inhoud opslaan in een LOB-app (Line-Of-Business) of gegevensopslag.

Voor meer informatie, zie:

Als u uw eigen LOB-apps wilt verbinden en deze API's in uw werkstroom wilt gebruiken, voegt u meer acties toe of schrijft u aangepaste API's.

Verwante inhoud

  • Last updated on