Exchange X12-üzenetek munkafolyamatokkal az Azure Logic Appsben

A következőkre vonatkozik: Azure Logic Apps (Használat + Standard)

Ha X12-üzeneteket szeretne küldeni és fogadni az Azure Logic Apps használatával létrehozott munkafolyamatokban, használja az X12-összekötőt , amely az X12-kommunikációt támogató és kezelő műveleteket nyújt.

Ez az útmutató bemutatja, hogyan adhat hozzá X12 kódolási és dekódolási műveleteket egy meglévő logikai alkalmazás munkafolyamatához. Az X12-összekötő nem tartalmaz eseményindítókat, így bármilyen eseményindítóval elindíthatja a munkafolyamatot. Az útmutatóban szereplő példák a Kérelem eseményindítót használják.

Csatlakozás or műszaki referencia

Az X12-összekötő egy verzióval rendelkezik a több-bérlős Azure Logic Apps, az egybérlős Azure Logic Apps és az integrációs szolgáltatási környezet (I Standard kiadás) munkafolyamataiban. Az X12-összekötőről az alábbi dokumentációban talál műszaki információkat:

Előfeltételek

  • Azure-fiók és -előfizetés. Ha még nem rendelkezik Azure-előfizetéssel, regisztráljon egy ingyenes Azure-fiókra.

  • Egy integrációs fiók erőforrása , amelyben összetevőket határoz meg és tárol, például kereskedelmi partnereket, megállapodásokat, tanúsítványokat stb. a vállalati integrációs és B2B-munkafolyamatokban való használatra. Ennek az erőforrásnak meg kell felelnie a következő követelményeknek:

    • Az integrációs fióknak és a logikai alkalmazás erőforrásának ugyanabban az Azure-előfizetésben és Azure-régióban kell lennie.

    • Legalább két kereskedelmi partnert definiál, akik részt vesznek a munkafolyamatban használt X12 műveletben. Mindkét partner definícióinak ugyanazt az X12 üzleti identitás-minősítőt kell használniuk.

    • X12-megállapodást határoz meg a munkafolyamatban részt vevő kereskedelmi partnerek között. Minden szerződéshez gazdagéppartnerre és vendégpartnerre van szükség. Az Ön és a másik partner közötti üzenetek tartalmának meg kell egyeznie a szerződés típusával. Az üzenetek fogadása és küldése során használandó szerződésbeállításokról az X12 üzenetbeállítások című témakörben olvashat.

      Fontos

      Ha a Health Insurance Portability and Accountability Act (HIPAA) sémáival dolgozik, egy szakaszt schemaReferences kell hozzáadnia a szerződéshez. További információ: HIPAA-sémák és üzenettípusok.

    • Meghatározza az XML-ellenőrzéshez használandó sémákat .

      Fontos

      Ha a Health Insurance Portability and Accountability Act (HIPAA) sémáival dolgozik, mindenképpen tekintse át a HIPAA-sémákat és az üzenettípusokat.

  • Attól függően, hogy használatalapú vagy standard logikaialkalmazás-munkafolyamaton dolgozik-e, a logikai alkalmazás erőforrásának szüksége lehet az integrációs fiókra mutató hivatkozásra:

    Logikai alkalmazás munkafolyamata Csatolás szükséges?
    Felhasználás Csatlakozás integrációs fiókhoz való csatolásra van szükség. A kapcsolatot akkor hozhatja létre, ha hozzáadja az X12 műveletet a munkafolyamathoz.
    Standard Csatlakozás integrációs fiókhoz való csatlakozás szükséges, de nincs szükség hivatkozásra. A kapcsolatot akkor hozhatja létre, ha hozzáadja az X12 műveletet a munkafolyamathoz.
  • A logikai alkalmazás erőforrása és munkafolyamata, ahol az X12-műveleteket használni szeretné.

    További információért lásd a következő dokumentációt:

X12-üzenetek kódolása

Az Encode to X12 üzenetművelet a következő feladatokat hajtja végre:

  • A szerződés feloldása a feladó és a fogadó környezeti tulajdonságainak egyeztetésével.
  • Szerializálja az EDI-csomópontot, és EDI-tranzakciókészletekké alakítja az XML-kódolt üzeneteket a csomópontban.
  • Tranzakciókészlet fejléc- és pótkocsiszegmenseit alkalmazza.
  • Létrehoz egy csomópont-vezérlési számot, egy csoportvezérlőszámot és egy tranzakciókészlet-vezérlőszámot minden kimenő csomóponthoz.
  • A hasznos adatok elválasztóit cseréli le.
  • Ellenőrzi az EDI és a partnerspecifikus tulajdonságokat.
    • A tranzakciókészlet adatelemeinek sémaérvényesítése az üzenetsémával.
    • EDI-ellenőrzés a tranzakciókészlet adatelemén.
    • Kiterjesztett ellenőrzés a tranzakciókészlet adatelemén.
  • Ha konfigurálva van, technikai és funkcionális visszaigazolást kér.
    • A fejléc érvényesítése eredményeként technikai visszaigazolást hoz létre. A műszaki visszaigazolás a címvevő által a cserefej és a pótkocsi feldolgozásának állapotát jelenti.
    • Funkcionális nyugtázást hoz létre a törzsellenőrzés eredményeként. A funkcionális nyugtázás a fogadott dokumentum feldolgozása során észlelt hibákról számol be.
  1. Az Azure Portalon nyissa meg a logikai alkalmazás erőforrását és munkafolyamatát a tervezőben.

  2. A tervezőben az alábbi általános lépéseket követve adja hozzá az X12-üzenethez az Encode nevű X12-műveletet szerződésnév alapján a munkafolyamathoz.

    Megjegyzés:

    Ha ehelyett az X12-üzenet kódolását szeretné használni identitásművelet szerint, akkor később különböző értékeket kell megadnia, például az X12-szerződés által megadott feladóazonosítót és fogadóazonosítót . Meg kell adnia a kódolni kívánt XML-üzenetet is, amely lehet az eseményindító vagy az előző művelet kimenete.

  3. Amikor a rendszer kéri, adja meg az alábbi kapcsolati adatokat az integrációs fiókhoz:

    Tulajdonság Kötelező Leírás
    Kapcsolat neve Igen A kapcsolat neve
    Integrációs fiók Igen Az elérhető integrációs fiókok listájában válassza ki a használni kívánt fiókot.

    Például:

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

  4. Amikor elkészült, válassza a Létrehozás lehetőséget.

  5. Az X12 műveletinformációs mezőben adja meg a következő tulajdonságértékeket:

    Tulajdonság Kötelező Leírás
    X12-szerződés neve Igen A használni kívánt X12-szerződés.
    Kódolandó XML-üzenet Igen A kódolni kívánt XML-üzenet
    Egyéb paraméterek Nem Ez a művelet a következő egyéb paramétereket tartalmazza:

    - Adatelem-elválasztó
    - Összetevő-elválasztó
    - Helyettesítő karakter
    - Szegmens-terminátor
    - Szegmens terminátor utótagja
    - Verziószám vezérlése
    - Alkalmazásküldő azonosítója/GS02-kód
    - Alkalmazás fogadóazonosítója/GS03-kód

    További információkért tekintse át az X12-üzenet beállításait.

    Az XML-üzenet hasznos adataként használhatja például a Kérelem eseményindító Törzs tartalomkimenetét:

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

X12-üzenetek dekódolás

Az X12-üzenet dekódolása művelet a következő feladatokat hajtja végre:

  • Ellenőrzi a borítékot a kereskedelmi partnerszerződéssel szemben.

  • Ellenőrzi az EDI és a partnerspecifikus tulajdonságokat.

    • EDI-szerkezeti ellenőrzés és kiterjesztett sémaérvényesítés
    • Borítékok közötti szerkezeti ellenőrzés
    • A boríték sémaellenőrzése a vezérlőséma alapján
    • A tranzakciókészlet adatelemeinek sémaérvényesítése az üzenetsémával
    • EDI-ellenőrzés tranzakciókészlet-adatelemeken
  • Ellenőrzi, hogy a csomópont-, csoport- és tranzakciókészlet-vezérlőszámok nem ismétlődnek-e.

    • Ellenőrzi a csomópont-vezérlés számát a korábban kapott csomópontok között.
    • Ellenőrzi a csoportvezérlő számát a csomópont többi csoportvezérlő számával szemben.
    • Ellenőrzi a tranzakciókészlet vezérlőszámát a csoport többi tranzakciókészlet-vezérlőszámával szemben.
  • Feloszt egy csomópontot tranzakciókészletekre, vagy megőrzi a teljes csomópontot:

    • Ossza fel a felcserélődést tranzakciókészletekre, vagy függessze fel a tranzakciókészleteket hiba esetén: Elemezheti az egyes tranzakciókészleteket. Az X12 dekódoló művelet csak azokat a tranzakciókészleteket adja ki, amelyek nem érvényesítik badMessagesa műveletet, és a többi tranzakciókészletet a következőre goodMessagesállítja ki: .

    • Ossza fel a csomópontot tranzakciókészletekre, vagy függessze fel a felcserélődést hiba esetén: Elemezheti az egyes tranzakciókészleteket. Ha egy vagy több tranzakciókészlet a felcseréléssel kapcsolatos sikertelen érvényesítés során, az X12 dekódoló művelet a csomópontban lévő összes tranzakciókészletet a következőre badMessagesállítja ki: .

    • Őrizze meg a tranzakciókészleteket hiba esetén, vagy függessze fel a tranzakciókészleteket: Őrizze meg a csomópontot, és dolgozza fel a teljes kötegelt csomópontot. Az X12 dekódoló művelet csak azokat a tranzakciókészleteket adja ki, amelyek nem érvényesítik badMessagesa műveletet, és a többi tranzakciókészletet a következőre goodMessagesállítja ki: .

    • Őrizze meg a csomópontot, vagy függessze fel a felcserélődést hiba esetén: Őrizze meg a csomópontot, és dolgozza fel a teljes kötegelt csomópontot. Ha egy vagy több tranzakciókészlet a felcseréléssel kapcsolatos sikertelen érvényesítés során, az X12 dekódoló művelet a csomópontban lévő összes tranzakciókészletet a következőre badMessagesállítja ki: .

  • Ha konfigurálva van, létrehoz egy technikai és funkcionális nyugtát.

    • A fejléc érvényesítése eredményeként technikai visszaigazolást hoz létre. A műszaki visszaigazolás a címvevő által a cserefej és a pótkocsi feldolgozásának állapotát jelenti.
    • Funkcionális nyugtázást hoz létre a törzsellenőrzés eredményeként. A funkcionális nyugtázás a fogadott dokumentum feldolgozása során észlelt hibákról számol be.
  1. Az Azure Portalon nyissa meg a logikai alkalmazás erőforrását és munkafolyamatát a tervezőben.

  2. A tervezőben kövesse az alábbi általános lépéseket az X12-üzenet decode X12 nevű műveletének a munkafolyamathoz való hozzáadásához.

  3. Amikor a rendszer kéri, adja meg az alábbi kapcsolati adatokat az integrációs fiókhoz:

    Tulajdonság Kötelező Leírás
    Kapcsolat neve Igen A kapcsolat neve
    Integrációs fiók Igen Az elérhető integrációs fiókok listájában válassza ki a használni kívánt fiókot.

    Például:

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

  4. Amikor elkészült, válassza a Létrehozás lehetőséget.

  5. Az X12 műveletinformációs mezőben adja meg a következő tulajdonságértékeket:

    Tulajdonság Kötelező Leírás
    X12 egybesimított fájlüzenet dekódolásához Igen Az X12-üzenet egyszerű fájlformátumban a dekódoláshoz

    Megjegyzés: Az xml-üzenet hasznos adattartalma vagy az üzenettömb tartalma – jó vagy rossz – base64 kódolású. Ezért olyan kifejezést kell használnia, amely feldolgozza ezt a tartalmat. A következő kifejezés például XML-ként dolgozza fel az üzenet tartalmát:

    xml(base64ToBinary(item()?['Body']))
    Egyéb paraméterek Nem Ez a művelet a következő egyéb paramétereket tartalmazza:

    - Az interchange megőrzése
    - Váltás felfüggesztése hiba miatt

    További információkért tekintse át az X12-üzenet beállításait.

    Használhatja például a Kérelem eseményindító Törzs tartalomkimenetét XML-üzenet hasznos adatként, de először elő kell dolgoznia ezt a tartalmat egy kifejezéssel:

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

További lépések