Exchange X12-meddelanden med hjälp av arbetsflöden i Azure Logic Apps

  • Artikel

Gäller för: Azure Logic Apps (Förbrukning + Standard)

Om du vill skicka och ta emot X12-meddelanden i arbetsflöden som du skapar med Hjälp av Azure Logic Apps använder du X12-anslutningsappen, som tillhandahåller åtgärder som stöder och hanterar X12-kommunikation.

Den här instruktionsguiden visar hur du lägger till X12-kodnings- och avkodningsåtgärder i ett befintligt logikapparbetsflöde. X12-anslutningsappen innehåller inga utlösare, så du kan använda valfri utlösare för att starta arbetsflödet. Exemplen i den här guiden använder utlösaren Förfrågning.

Anslut eller teknisk referens

X12-anslutningsappen har en version mellan arbetsflöden i Azure Logic Apps med flera klientorganisationer, Azure Logic Apps med en enda klient och integrationstjänstmiljön (ISE). Teknisk information om X12-anslutningsappen finns i följande dokumentation:

Förutsättningar

  • Ett Azure-konto och prenumeration. Om du inte har någon Azure-prenumeration än registrerar du dig för ett kostnadsfritt Azure-konto.

  • En integrationskontoresurs där du definierar och lagrar artefakter, till exempel handelspartner, avtal, certifikat och så vidare, för användning i dina företagsintegrerings- och B2B-arbetsflöden. Den här resursen måste uppfylla följande krav:

    • Både integrationskontot och logikappresursen måste finnas i samma Azure-prenumeration och Azure-region.

    • Definierar minst två handelspartner som deltar i X12-åtgärden som används i arbetsflödet. Definitionerna för båda partnerna måste använda samma X12-företagsidentitetskvalificerare.

    • Definierar ett X12-avtal mellan de handelspartner som deltar i ditt arbetsflöde. Varje avtal kräver en värdpartner och en gästpartner. Innehållet i meddelandena mellan dig och den andra partnern måste matcha avtalstypen. Information om avtalsinställningar som ska användas när du tar emot och skickar meddelanden finns i X12-meddelandeinställningar.

      Viktigt!

      Om du arbetar med HIPAA-scheman (Health Insurance Portability and Accountability Act) måste du lägga till ett schemaReferences avsnitt i ditt avtal. Mer information finns i HIPAA-scheman och meddelandetyper.

    • Definierar de scheman som ska användas för XML-validering.

      Viktigt!

      Om du arbetar med HIPAA-scheman (Health Insurance Portability and Accountability Act) bör du granska HIPAA-scheman och meddelandetyper.

  • Beroende på om du arbetar med ett arbetsflöde för förbrukning eller standardlogikapp kan logikappresursen kräva en länk till ditt integrationskonto:

    Arbetsflöde för logikapp Krävs länk?
    Förbrukning Anslut ion och länk till integrationskontot krävs. Du kan skapa anslutningen när du lägger till X12-åtgärden i arbetsflödet.
    Standard Anslut ion till integrationskontot krävs, men ingen länk krävs. Du kan skapa anslutningen när du lägger till X12-åtgärden i arbetsflödet.

  • Logikappens resurs och arbetsflöde där du vill använda X12-åtgärderna.

    Mer information finns i följande dokumentation:

Koda X12-meddelanden

Åtgärden Koda till X12-meddelande utför följande uppgifter:

  • Löser avtalet genom att matcha egenskaperna för avsändare och mottagarkontext.
  • Serialiserar EDI-utbytet och konverterar XML-kodade meddelanden till EDI-transaktionsuppsättningar i utbytet.
  • Tillämpar rubrik- och trailersegment för transaktionsuppsättningar.
  • Genererar ett utbyteskontrollnummer, ett gruppkontrollnummer och ett transaktionsuppsättningskontrollnummer för varje utgående utbyte.
  • Ersätter avgränsare i nyttolastdata.
  • Validerar EDI och partnerspecifika egenskaper.
    • Schemavalidering av transaktionsuppsättningsdataelement mot meddelandeschemat.
    • EDI-validering på transaktionsuppsättningsdataelement.
    • Utökad validering av transaktionsuppsättningsdataelement.
  • Begär en teknisk och funktionell bekräftelse om den har konfigurerats.
    • Genererar en teknisk bekräftelse som ett resultat av sidhuvudvalidering. Den tekniska bekräftelsen rapporterar status för bearbetningen av en utbytesrubrik och släpvagn av adressmottagaren.
    • Genererar en funktionsbekräftelse som ett resultat av kroppsvalidering. Funktionsbekräftelse rapporterar varje fel som påträffades när det mottagna dokumentet bearbetades.

  1. Öppna logikappresursen och arbetsflödet i designern i Azure-portalen.

  2. I designern följer du de här allmänna stegen för att lägga till X12-åtgärden med namnet Koda i X12-meddelande efter avtalsnamn i arbetsflödet.

    Kommentar

    Om du vill använda åtgärden Koda till X12 med identiteter i stället måste du senare ange olika värden, till exempel avsändarens identifierare och mottagaridentifieraren som anges i ditt X12-avtal. Du måste också ange XML-meddelandet som ska kodas, vilket kan vara utdata från utlösaren eller en föregående åtgärd.

  3. När du uppmanas till det anger du följande anslutningsinformation för ditt integrationskonto:

    Property Obligatoriskt Beskrivning
    Anslutningens namn Ja Ett namn på anslutningen
    Integrationskonto Ja I listan över tillgängliga integrationskonton väljer du det konto som ska användas.

    Till exempel:

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

  4. Välj Skapa när du är klar.

  5. Ange följande egenskapsvärden i rutan X12-åtgärdsinformation:

    Property Obligatoriskt Beskrivning
    Namn på X12-avtal Ja X12-avtalet som ska användas.
    XML-meddelande som ska kodas Ja XML-meddelandet som ska kodas
    Andra parametrar Nej Den här åtgärden innehåller följande andra parametrar:

    - Avgränsare för dataelement
    - Komponentavgränsare
    - Ersättningstecken
    - Segmentavgränsare
    - Segmentavslutarsuffix
    - Kontrollera versionsnummer
    - Programsändaridentifierare/kod GS02
    - Application Receiver Identifier/Code GS03

    Mer information finns i X12-meddelandeinställningar.

    Du kan till exempel använda brödtextinnehållsutdata från utlösaren Begäran som XML-meddelandenyttolast:

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

Avkoda X12-meddelanden

Åtgärden Avkoda X12-meddelande utför följande uppgifter:

  • Validerar kuvertet mot handelspartneravtalet.

  • Validerar EDI och partnerspecifika egenskaper.

    • EDI-strukturell validering och utökad schemavalidering
    • Strukturvalidering av utväxlingskuvert
    • Schemavalidering av kuvertet mot kontrollschemat
    • Schemaverifiering av transaktionsuppsättningens dataelement mot meddelandeschemat
    • EDI-validering för transaktionsuppsättningsdataelement

  • Verifierar att kontrollnumren för utbyte, grupp och transaktionsuppsättning inte är dubbletter.

    • Kontrollerar utbyteskontrollnumret mot tidigare mottagna utbyten.
    • Kontrollerar gruppkontrollnumret mot andra gruppkontrollnummer i utbytet.
    • Kontrollerar kontrollnumret för transaktionsuppsättningen mot andra kontrollnummer för transaktionsuppsättningar i den gruppen.

  • Delar upp ett utbyte i transaktionsuppsättningar eller bevarar hela utbytet:

    • Dela upp utbytet i transaktionsuppsättningar eller pausa transaktionsuppsättningar vid fel: Parsa varje transaktionsuppsättning. X12-avkodningsåtgärden matar endast ut de transaktionsuppsättningar som inte verifieras till badMessagesoch matar ut de återstående transaktionerna till goodMessages.

    • Dela upp utbytet i transaktionsuppsättningar eller pausa utbyte vid fel: Parsa varje transaktionsuppsättning. Om en eller flera transaktionsuppsättningar i utbytesverifieringen misslyckas matar X12-avkodningsåtgärden ut alla transaktionsuppsättningar i det utbytet till badMessages.

    • Bevara transaktionsuppsättningarna för utbyte eller pausa vid fel: Bevara utbytet och bearbeta hela batchutbytet. X12-avkodningsåtgärden matar endast ut de transaktionsuppsättningar som inte verifieras till badMessagesoch matar ut de återstående transaktionerna till goodMessages.

    • Bevara utbytet eller pausa utbytet vid fel: Bevara utbytet och bearbeta hela batchutbytet. Om en eller flera transaktionsuppsättningar i utbytesverifieringen misslyckas matar X12-avkodningsåtgärden ut alla transaktionsuppsättningar i det utbytet till badMessages.

  • Genererar en teknisk och funktionell bekräftelse om den är konfigurerad.

    • Genererar en teknisk bekräftelse som ett resultat av sidhuvudvalidering. Den tekniska bekräftelsen rapporterar status för bearbetningen av en utbytesrubrik och släpvagn av adressmottagaren.
    • Genererar en funktionsbekräftelse som ett resultat av kroppsvalidering. Funktionsbekräftelse rapporterar varje fel som påträffades när det mottagna dokumentet bearbetades.

  1. Öppna logikappresursen och arbetsflödet i designern i Azure-portalen.

  2. I designern följer du de här allmänna stegen för att lägga till X12-åtgärden med namnet Avkoda X12-meddelande i arbetsflödet.

  3. När du uppmanas till det anger du följande anslutningsinformation för ditt integrationskonto:

    Property Obligatoriskt Beskrivning
    Anslutningens namn Ja Ett namn på anslutningen
    Integrationskonto Ja I listan över tillgängliga integrationskonton väljer du det konto som ska användas.

    Till exempel:

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

  4. Välj Skapa när du är klar.

  5. Ange följande egenskapsvärden i rutan X12-åtgärdsinformation:

    Property Obligatoriskt Beskrivning
    X12 flat filmeddelande att avkoda Ja X12-meddelandet i platt filformat för avkodning

    Obs! XML-meddelandets nyttolast eller innehåll för meddelandematrisen, bra eller dåligt, är base64-kodad. Därför måste du använda ett uttryck som bearbetar det här innehållet. Följande uttryck bearbetar till exempel meddelandeinnehållet som XML:

    xml(base64ToBinary(item()?['Body']))
    Andra parametrar Nej Den här åtgärden innehåller följande andra parametrar:

    - Bevara utbyte
    - Pausa utbyte vid fel

    Mer information finns i X12-meddelandeinställningar.

    Du kan till exempel använda brödtextinnehållsutdata från utlösaren Begäran som XML-meddelandenyttolast, men du måste först förbearbeta innehållet med ett uttryck:

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

Nästa steg