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:
Csatlakozás or referenciaoldal, amely az összekötő Swagger-fájljában dokumentált eseményindítókat, műveleteket és korlátokat ismerteti
B2B protokollkorlátok az üzenetméretekhez
Például egy integrációs szolgáltatási környezetben (I Standard kiadás) az összekötő I Standard kiadás verziója az I Standard kiadás B2B üzenetkorlátait használja.
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.
Az Azure Portalon nyissa meg a logikai alkalmazás erőforrását és munkafolyamatát a tervezőben.
-
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.
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:
Amikor elkészült, válassza a Létrehozás lehetőséget.
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:
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
badMessages
a műveletet, és a többi tranzakciókészletet a következőregoodMessages
á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
badMessages
a műveletet, és a többi tranzakciókészletet a következőregoodMessages
á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.
Az Azure Portalon nyissa meg a logikai alkalmazás erőforrását és munkafolyamatát a tervezőben.
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.
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:
Amikor elkészült, válassza a Létrehozás lehetőséget.
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: