Share via

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.

Technische naslaginformatie over connectoren

De X12-connector heeft één versie voor werkstromen in multitenant Azure Logic Apps en Azure Logic Apps met één tenant. 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 en koppeling naar integratieaccount zijn vereist. U kunt de verbinding maken wanneer u de X12-bewerking aan uw werkstroom toevoegt.
    Standaard Verbinding met integratieaccount vereist, maar geen koppeling vereist. 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.

    Voorbeeld:

    Schermopname van verbruikswerkstroom en verbindingsinformatie voor actie met de naam Coderen naar X12-bericht op overeenkomstnaam.

  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:

    Schermopname van de werkstroom Verbruik, de actie Coderen naar X12-bericht op overeenkomstnaam en actie-eigenschappen.

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.

    Voorbeeld:

    Schermopname van verbruikswerkstroom en verbindingsgegevens voor actie met de naam X12-bericht decoderen.

  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:

    Schermopname van verbruikswerkstroom, actie met de naam X12-bericht decoderen en actie-eigenschappen.

Volgende stappen