X12-berichten uitwisselen met behulp van werkstromen in Azure Logic Apps

  • Artikel

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

Als u X12-berichten wilt verzenden en ontvangen in werkstromen die u maakt met behulp van Azure Logic Apps, gebruikt u de X12-connector , die bewerkingen biedt die X12-communicatie ondersteunen en beheren.

Deze handleiding laat zien hoe u de X12-coderings- en decoderingsacties toevoegt aan een bestaande werkstroom voor logische apps. De X12-connector bevat geen triggers, dus u kunt elke trigger gebruiken om uw werkstroom te starten. In de voorbeelden in deze handleiding wordt de aanvraagtrigger gebruikt.

Verbinding maken of technische naslaginformatie

De X12-connector heeft één versie in werkstromen in Azure Logic Apps met meerdere tenants, Azure Logic Apps met één tenant en de integratieserviceomgeving (ISE). Raadpleeg de volgende documentatie voor technische informatie over de X12-connector :

Vereisten

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

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

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

    • Definieert ten minste twee handelspartners die deelnemen aan de X12-bewerking die in uw werkstroom wordt gebruikt. De definities voor beide partners moeten dezelfde X12-bedrijfsidentiteitskwalificatie gebruiken.

    • Definieert een 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 u en de andere partner moet overeenkomen met het overeenkomsttype. Zie X12-berichtinstellingen voor informatie over overeenkomstinstellingen die u kunt gebruiken bij het ontvangen en verzenden van berichten.

      Belangrijk

      Als u werkt met HIPAA-schema's (Health Insurance Portability and Accountability Act), moet u een schemaReferences sectie toevoegen aan uw overeenkomst. Zie HIPAA-schema's en berichttypen voor meer informatie.

    • Definieert de schema's die moeten worden gebruikt voor XML-validatie.

      Belangrijk

      Als u werkt met HIPAA-schema's (Health Insurance Portability and Accountability Act), moet u HIPAA-schema's en berichttypen controleren.

  • Op basis van of u aan een werkstroom voor een logische of standaard logische app werkt, is voor uw logische app-resource mogelijk een koppeling naar uw integratieaccount vereist:

    Werkstroom voor logische apps Koppeling vereist?
    Verbruik Verbinding maken ion en koppeling naar integratieaccount zijn vereist. U kunt de verbinding maken wanneer u de X12-bewerking aan uw werkstroom toevoegt.
    Standaard Verbinding maken ion to integration account required, but no link required. U kunt de verbinding maken wanneer u de X12-bewerking aan uw werkstroom toevoegt.

  • De resource en werkstroom van de logische app waar u de X12-bewerkingen wilt gebruiken.

    Voor meer informatie raadpleegt u de volgende documentatie:

X12-berichten coderen

De bewerking Coderen naar X12-bericht voert de volgende taken uit:

  • Lost de overeenkomst op door overeenkomende eigenschappen van de afzender- en ontvangercontext op te lossen.
  • Serialiseert de EDI-uitwisseling en converteert XML-gecodeerde berichten naar EDI-transactiesets in de uitwisseling.
  • Past header- en trailersegmenten van transactiesets toe.
  • Genereert een uitwisselingsbeheernummer, een groepsbeheernummer en een transactiesetbeheernummer voor elke uitgaande uitwisseling.
  • Vervangt scheidingstekens in de nettoladinggegevens.
  • Valideert EDI- en partnerspecifieke eigenschappen.
    • Schemavalidatie van transactiesetgegevenselementen op basis van het berichtschema.
    • EDI-validatie voor transactiesetgegevenselementen.
    • Uitgebreide validatie voor transactiesetgegevenselementen.
  • Vraagt een technische en functionele bevestiging aan, indien geconfigureerd.
    • Hiermee wordt een technische bevestiging gegenereerd als gevolg van headervalidatie. De technische bevestiging rapporteert de status van de verwerking van een uitwisselingskop en trailer door de adresontvanger.
    • Genereert een functionele bevestiging als gevolg van de validatie van de hoofdtekst. De functionele bevestiging rapporteert elke fout die is opgetreden tijdens het verwerken van het ontvangen document.

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

  2. Volg deze algemene stappen in de ontwerpfunctie om de X12-actie Coderen toe te voegen aan X12-bericht op overeenkomstnaam aan uw werkstroom.

    Notitie

    Als u in plaats daarvan de actie Coderen naar X12-bericht wilt gebruiken op basis van identiteiten , moet u later verschillende waarden opgeven, zoals de afzender-id en ontvanger-id die is opgegeven door uw X12-overeenkomst. U moet ook het XML-bericht opgeven om te coderen. Dit kan de uitvoer zijn van de trigger of een voorgaande actie.

  3. Geef de volgende verbindingsgegevens op voor uw integratieaccount wanneer u hierom wordt gevraagd:

    Eigenschappen Vereist Beschrijving
    Verbindingsnaam Ja Een naam voor de verbinding
    Integratieaccount Ja Selecteer in de lijst met beschikbare integratieaccounts het account dat u wilt gebruiken.

    Bijvoorbeeld:

    Screenshot showing Consumption workflow and connection information for action named Encode to X12 message by agreement name.

  4. Selecteer Maken als u klaar bent.

  5. Geef in het vak informatie over de X12-actie de volgende eigenschapswaarden op:

    Eigenschappen Vereist Beschrijving
    Naam van X12-overeenkomst Ja De X12-overeenkomst die moet worden gebruikt.
    XML-bericht om te coderen Ja Het XML-bericht dat moet worden gecodeerd
    Andere parameters Nee Deze bewerking bevat de volgende andere parameters:

    - Scheidingsteken voor gegevenselementen
    - Onderdeelscheidingsteken
    - Vervangend teken
    - Segmenteindteken
    - Achtervoegsel segmenteindteken
    - Versienummer van besturingselement
    - Id/code van toepassingszender GS02
    - Toepassingsontvanger-/code GS03

    Raadpleeg de X12-berichtinstellingen voor meer informatie.

    U kunt bijvoorbeeld de uitvoer van de hoofdtekst van de aanvraagtrigger gebruiken als de nettolading van het XML-bericht:

    Screenshot showing Consumption workflow, action named Encode to X12 message by agreement name, and action properties.

X12-berichten decoderen

De berichtbewerking X12 decoderen voert de volgende taken uit:

  • Valideert de envelop tegen handelspartnerovereenkomst.

  • Valideert EDI- en partnerspecifieke eigenschappen.

    • EDI structurele validatie en uitgebreide schemavalidatie
    • Structurele validatie van envelop door uitwisseling
    • Schemavalidatie van de envelop op basis van het besturingsschema
    • Schemavalidatie van de gegevenselementen van de transactieset op basis van het berichtschema
    • EDI-validatie voor gegevenselementen van transactieset

  • Controleert of de controlenummers voor de uitwisseling, groep en transactieset geen duplicaten zijn.

    • Controleert het uitwisselingsbeheernummer tegen eerder ontvangen uitwisselingen.
    • Hiermee wordt het groepsbeheernummer gecontroleerd op andere groepsbeheernummers in de uitwisseling.
    • Hiermee wordt het controlenummer van de transactieset gecontroleerd op andere transactiesetbeheernummers in die groep.

  • Splitst een uitwisseling in transactiesets of behoudt de gehele uitwisseling:

    • Splits de uitwisseling in transactiesets of onderbreekt transactiesets bij fout: Elke transactieset parseren. De X12-decodeeractie voert alleen de transactiesets uit waarop de validatie badMessagesmislukt en voert de resterende transactiesets uit op goodMessages.

    • Splits de uitwisseling in transactiesets of onderbreekt de uitwisseling op fout: Elke transactieset parseren. Als een of meer transactiesets in de uitwisselingsvalidatie mislukken, voert de X12-decoderen alle transactiesets in die uitwisseling uit naar badMessages.

    • Behoud de uitwisselings- of onderbrekingstransactiesets bij fout: behoud de uitwisseling en het verwerken van de gehele batch-uitwisseling. De X12-decodeeractie voert alleen de transactiesets uit waarop de validatie badMessagesmislukt en voert de resterende transactiesets uit op goodMessages.

    • Behoud de uitwisseling of onderbreking van de uitwisseling op fout: behoud de uitwisseling en het verwerken van de gehele batch-uitwisseling. Als een of meer transactiesets in de uitwisselingsvalidatie mislukken, voert de X12-decoderen alle transactiesets in die uitwisseling uit naar badMessages.

  • Hiermee wordt een technische en functionele bevestiging gegenereerd, indien geconfigureerd.

    • Hiermee wordt een technische bevestiging gegenereerd als gevolg van headervalidatie. De technische bevestiging rapporteert de status van de verwerking van een uitwisselingskop en trailer door de adresontvanger.
    • Genereert een functionele bevestiging als gevolg van de validatie van de hoofdtekst. De functionele bevestiging rapporteert elke fout die is opgetreden tijdens het verwerken van het ontvangen document.

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

  2. Volg deze algemene stappen in de ontwerpfunctie om de X12-actie met de naam X12-bericht aan uw werkstroom toe te voegen.

  3. Geef de volgende verbindingsgegevens op voor uw integratieaccount wanneer u hierom wordt gevraagd:

    Eigenschappen Vereist Beschrijving
    Verbindingsnaam Ja Een naam voor de verbinding
    Integratieaccount Ja Selecteer in de lijst met beschikbare integratieaccounts het account dat u wilt gebruiken.

    Bijvoorbeeld:

    Screenshot showing Consumption workflow and connection information for action named Decode X12 message.

  4. Selecteer Maken als u klaar bent.

  5. Geef in het vak informatie over de X12-actie de volgende eigenschapswaarden op:

    Eigenschappen Vereist Beschrijving
    X12-bericht met plat bestand om te decoderen Ja Het X12-bericht in platte bestandsindeling om te decoderen

    Opmerking: de nettolading of inhoud van het XML-bericht voor de berichtmatrix, goed of slecht, is base64 gecodeerd. U moet dus een expressie gebruiken waarmee deze inhoud wordt verwerkt. De volgende expressie verwerkt bijvoorbeeld de berichtinhoud als XML:

    xml(base64ToBinary(item()?['Body']))
    Andere parameters Nee Deze bewerking bevat de volgende andere parameters:

    - Interchange behouden
    - Interchange on Error onderbreken

    Raadpleeg de X12-berichtinstellingen voor meer informatie.

    U kunt bijvoorbeeld de uitvoer van de hoofdtekst van de aanvraagtrigger gebruiken als de nettolading van het XML-bericht, maar u moet deze inhoud eerst vooraf verwerken met behulp van een expressie:

    Screenshot showing Consumption workflow, action named Decode X12 message, and action properties.

Volgende stappen