Exchange EDIFACT-üzenetek munkafolyamatok használatával az Azure Logic Appsben

Ha EDIFACT-üzeneteket szeretne küldeni és fogadni az Azure Logic Apps használatával létrehozott munkafolyamatokban, használja az EDIFACT-összekötőt , amely olyan műveleteket biztosít, amelyek támogatják és kezelik az EDIFACT kommunikációt.

Ez az útmutató bemutatja, hogyan adhat hozzá EDIFACT kódolási és dekódolási műveleteket egy meglévő logikai alkalmazás munkafolyamatához. Ha nem érhető el EDIFACT-eseményindító , bármelyik 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 EDIFACT-összekötő különböző verziókkal rendelkezik, a logikai alkalmazás típusa és a gazdagépkörnyezet alapján.

Logikai alkalmazás Environment Csatlakozás or verzió
Használat több-bérlős Azure Logic Apps EDIFACT felügyelt összekötő (Standard osztály). Az EDIFACT-összekötő csak műveleteket biztosít, de bármilyen eseményindítót használhat, amely a forgatókönyvéhez működik. További információkért tekintse meg a következő dokumentációt:

- EDIFACT felügyelt összekötő referenciája
- EDIFACT-üzenetkorlátok
Használat Integrációs szolgáltatási környezet (I Standard kiadás) Az EDIFACT felügyelt összekötője (Standard osztály) és az EDIFACT I Standard kiadás verziója, amely a Standard osztálytól eltérő üzenetkorlátokkal rendelkezik. Az EDIFACT-összekötő csak műveleteket biztosít, de bármilyen eseményindítót használhat, amely a forgatókönyvéhez működik. További információkért tekintse meg a következő dokumentációt:

- EDIFACT felügyelt összekötő referenciája
- EDIFACT-üzenetkorlátok
Standard Egybérlős Azure Logic Apps és App Service Environment v3 (csak Windows-csomagok esetén) Az EDIFACT beépített összekötője (előzetes verzió) és az EDIFACT által felügyelt összekötő. A beépített verzió a következő módokon különbözik:

– A beépített verzió csak műveleteket biztosít, de bármilyen eseményindítót használhat, amely a forgatókönyvéhez működik.

– A beépített verzió közvetlenül hozzáférhet az Azure-beli virtuális hálózatokhoz. Nincs szükség helyszíni adatátjáróra.

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

- EDIFACT felügyelt összekötő referenciája
- EDIFACT beépített összekötőműveletek
- EDIFACT-üzenetkorlátok

EDIFACT beépített műveletek (csak standard munkafolyamatok – előzetes verzió)

Az előzetes verziójú beépített EDIFACT-összekötő a következő műveletekkel rendelkezik, amelyek hasonlóak a megfelelő EDIFACT által felügyelt összekötőműveletekhez, kivéve, ha a korlátozások és az ismert problémák fel vannak jegyezve.

Korlátozások és ismert problémák

  • Előzetes verziójú beépített EDIFACT-összekötő

    • Ez a funkció előzetes verzióban érhető el, és a Microsoft Azure előzetes verziójának kiegészítő használati feltételei vonatkoznak.

    • Az összekötő műveletei jelenleg legalább 100 MB hasznos adatokat támogatnak.

    • Az előzetes verziójú EDIFACT Decode művelet jelenleg nem tartalmazza a következő képességeket:

      • Ha konfigurálva van, ellenőrizze a duplikált csomópontok, csoportok és tranzakciókészletek vezérlőszámát.

      • Őrizze meg a teljes csomópontot.

      Ellenkező esetben az előzetes EDIFACT Encode és az EDIFACT dekódoló beépített összekötőműveletek hasonló képességekkel rendelkeznek, mint a megfelelő EDIFACT által felügyelt összekötőműveletek.

    • Az összekötő műveletei jelenleg nem támogatják a több tranzakcióval vagy kötegelt üzenettel rendelkező csomópontokat.

    • Az összekötő műveletei jelenleg nem bocsátanak ki EDI-specifikus nyomkövetést.

Előfeltételek

  • Azure-fiók és -előfizetés. Ha még nem rendelkezik 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 határoz meg, akik részt vesznek a munkafolyamatban használt EDIFACT műveletben. Mindkét partner definícióinak ugyanazt az üzleti identitás-minősítőt kell használniuk, amely a ZZZ – Kölcsönösen definiálva ehhez a forgatókönyvhöz.

    • EDIFACT-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 EDIFACT üzenetbeállításai című témakörben olvashat bővebben.

      Fontos

      Az EDIFACT-összekötő csak UTF-8 karaktert támogat. Ha a kimenet váratlan karaktereket tartalmaz, ellenőrizze, hogy az EDIFACT-üzenetek az UTF-8 karakterkészletet használják-e.

  • 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?
    Consumption Csatlakozás integrációs fiókhoz való csatolásra van szükség. A kapcsolatot akkor hozhatja létre, ha hozzáadja az EDIFACT 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 EDIFACT műveletet a munkafolyamathoz.
  • A logikai alkalmazás erőforrása és munkafolyamata, ahol az EDIFACT-műveleteket használni szeretné.

    For more information, see the following documentation:

Encode EDIFACT messages

Az EDIFACT által felügyelt összekötő EDIFACT üzenetműveletének kódolása és az EDIFACT Encode nevű beépített összekötőművelet a következő feladatokat hajtja végre, kivéve, ha a Korlátozások és az ismert problémák című cikk feljegyezi:

  • A szerződés feloldása a feladó minősítőjének és fogadójának azonosítójának és azonosítójának egyeztetésével.

  • Szerializálja az elektronikus adatcserét (EDI), amely az XML-kódolású üzeneteket EDI-tranzakciókészletekké alakítja a csomópontban.

  • Tranzakciókészlet fejléc- és pótkocsiszegmenseinek alkalmazása.

  • Hozzon létre 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.

  • Cserélje le a hasznos adat elválasztóit.

  • Ellenőrizze az EDI- és partnerspecifikus tulajdonságokat, például a tranzakciókészlet adatelemeinek sémáját az üzenetsémán, a tranzakciókészlet adatelemeinek adatait, valamint a tranzakciókészlet adatelemeinek kiterjesztett érvényesítését.

  • Hozzon létre egy XML-dokumentumot az egyes tranzakciókészletekhez.

  • Ha konfigurálva van, kérjen technikai visszaigazolást, funkcionális nyugtázást vagy mindkettőt.

    • Technikai visszaigazolásként a CONTRL-üzenet egy csomópont nyugtázását jelzi.

    • Funkcionális nyugtázásként a CONTRL-üzenet a kapott csomópont, csoport vagy üzenet elfogadását vagy elutasítását jelzi, beleértve a hibák vagy a nem támogatott funkciók listáját.

  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 Encode nevű EDIFACT-műveletet az EDIFACT-üzenethez szerződésnév alapján a munkafolyamathoz.

    Megjegyzés:

    Ha ehelyett az EDIFACT-üzeneteket az EDIFACT-üzenethez szeretné használni identitásművelet szerint , akkor később különböző értékeket kell megadnia, például az EDIFACT-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. Adja meg a következő 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 shows Azure portal, Consumption workflow, and connection box for action named Encode to EDIFACT message by agreement name.

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

  5. Az EDIFACT műveletben adja meg a következő tulajdonságértékeket:

    Tulajdonság Kötelező Leírás
    Az EDIFACT-szerződés neve Igen A használni kívánt EDIFACT-szerződés.
    Kódolandó XML-üzenet Igen Az üzenet feladójának üzleti azonosítója az EDIFACT-szerződés által meghatározottak szerint
    Egyéb paraméterek Nem Ez a művelet a következő egyéb paramétereket tartalmazza:

    - Adatelem-elválasztó
    - Kiadásjelző
    - Összetevő-elválasztó
    - Ismétlődési elválasztó
    - Szegmens-terminátor
    - Szegmens terminátor utótagja
    - Tizedesjel

    További információ: EDIFACT üzenetbeállítások.

    A kódolandó XML-üzenet hasznos adata lehet például a Kérelem eseményindító törzstartalom-kimenete:

    Screenshot shows Consumption workflow, action named Encode to EDIFACT message by agreement name, and message encoding properties.

  6. Mentse a munkafolyamatot.

Decode EDIFACT messages

Az EDIFACT által felügyelt összekötő decode EDIFACT üzenetművelete és az EDIFACT Decode nevű beépített összekötőművelet a következő feladatokat hajtja végre, kivéve, ha a Korlátozások és az ismert problémák című témakör feljegyezi:

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

  • A szerződést úgy oldhatja fel, hogy megfelel a feladó minősítőjének és azonosítójának, valamint a fogadó minősítőnek és az azonosítónak.

  • Feloszthat egy csomópontot több tranzakciókészletre, ha a csomópont több tranzakcióval rendelkezik a szerződés Fogadási Gépház alapján.

  • Bontsa szét a csomópontot.

  • Ellenőrizze az elektronikus adatcserét (EDI) és a partnerspecifikus tulajdonságokat, például a felcserélési boríték szerkezetét, a borítéksémát a vezérlőséma alapján, a tranzakciókészlet adatelemeinek sémáját az üzenetsémán, valamint kiterjesztett ellenőrzést a tranzakciós adatelemeken.

  • Ellenőrizze, hogy a csomópont-, csoport- és tranzakciókészlet-vezérlőszámok nem duplikáltak-e (csak felügyelt összekötő), ha konfigurálva van, például:

    • Ellenőrizze a csomópont-vezérlés számát a korábban kapott csomópontok között.

    • Ellenőrizze a csoportvezérlő számát a másik csoportvezérlő számával a csomópontban.

    • Ellenőrizze a tranzakciókészlet vezérlőszámát a csoport többi tranzakciókészlet-vezérlőszámával.

  • Ossza fel a csomópontot tranzakciókészletekre, vagy őrizze meg a teljes csomópontot (csak felügyelt összekötő esetén), például:

    • Felosztási csomópont tranzakciókészletként – tranzakciókészletek felfüggesztése hiba miatt.

      A dekódolási művelet tranzakciókészletekre osztja a csomópontot, és elemzi az egyes tranzakciókészleteket. A 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: .

    • Az Interchange felosztása tranzakciókészletekként – függessze fel a felcserélődést a hiba miatt.

      A dekódolási művelet tranzakciókészletekre osztja a csomópontot, és elemzi az egyes tranzakciókészleteket. Ha egy vagy több tranzakciókészlet a felcseréléssel kapcsolatos sikertelen ellenőrzést hajtja végre, a művelet az adott csomópontban lévő összes tranzakciókészletet a következőre badMessagesállítja ki: .

    • Az Interchange megőrzése – tranzakciókészletek felfüggesztése hiba miatt.

      A dekódolási művelet megőrzi a csomópontot, és feldolgozza a teljes kötegelt csomópontot. A 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: .

    • Az Interchange megőrzése – a hiba felcserélődésének felfüggesztése.

      A dekódolási művelet megőrzi a csomópontot, és feldolgozza a teljes kötegelt csomópontot. Ha egy vagy több tranzakciókészlet a felcseréléssel kapcsolatos sikertelen ellenőrzést hajtja végre, a művelet az adott csomópontban lévő összes tranzakciókészletet a következőre badMessagesállítja ki: .

  • Ha konfigurálva van, technikai nyugtázást, funkcionális nyugtázást vagy mindkettőt generálhat.

    • Egy technikai visszaigazolás vagy a CONTRL ACK, amely a teljes fogadott csomópont szinaktikai ellenőrzésének eredményeit jelenti.

    • Funkcionális nyugtázás, amely elismeri a kapott felcserélődés vagy csoport elfogadását vagy elutasítását.

  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 EDIFACT művelet decode EDIFACT üzenetének a munkafolyamathoz való hozzáadásához.

  3. Adja meg a következő 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 shows Consumption workflow designer and connection pane for the action named Decode EDIFACT message.

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

  5. Az EDIFACT műveletben adja meg a következő tulajdonságértékeket:

    Tulajdonság Kötelező Leírás
    EDIFACT egybesimított fájlüzenet dekódolásához Igen A dekódolni kívánt XML-egyszerű fájlüzenet.
    Egyéb paraméterek Nem Ez a művelet a következő egyéb paramétereket tartalmazza:

    - Összetevő-elválasztó
    - Adatelem-elválasztó
    - Kiadásjelző
    - Ismétlődési elválasztó
    - Szegmens-terminátor
    - Szegmens terminátor utótagja
    - Tizedesjel
    - Hasznos adat karakterkészlete
    - Szegmens terminátor utótagja
    - Az interchange megőrzése
    - Felcserélés felfüggesztése hiba miatt

    További információ: EDIFACT üzenetbeállítások.

    A dekódolni kívánt XML-üzenet hasznos adata lehet például a Kérelem eseményindító törzstartalom-kimenete:

    Screenshot shows Consumption workflow, action named Decode EDIFACT message, and message decoding properties.

UNH2.5-szegmensek kezelése az EDIFACT-dokumentumokban

Az EDIFACT-dokumentumban az UNH2.5 szegmens használható a sémakereséshez. Ebben a minta EDIFACT-üzenetben például az UNH mező a következő EAN008:

UNH+SSDD1+ORDERS:D:03B:UN:EAN008

Az EDIFACT-dokumentum kezeléséhez vagy egy UN2.5-ös szegmenssel rendelkező EDIFACT-üzenet feldolgozásához kövesse az alábbi lépéseket:

  1. Az UNH2.5 gyökércsomópont nevével rendelkező séma frissítése vagy üzembe helyezése.

    Tegyük fel például, hogy a UNH mintamező sémagyökérne.EFACT_D03B_ORDERS_EAN008 Mindegyiknél D03B_ORDERS , amelynek eltérő UNH2.5 szegmense van, külön sémát kell üzembe helyeznie.

  2. Az Azure Portalon adja hozzá a sémát az integrációs fiók erőforrásához vagy a logikai alkalmazás erőforrásához attól függően, hogy Használat vagy Standard logikai alkalmazás munkafolyamattal rendelkezik-e.

  3. Függetlenül attól, hogy az EDIFACT dekódolási vagy kódolási műveletet használja, töltse fel a sémát, és állítsa be a sémabeállításokat az EDIFACT-szerződés Fogadási Gépház vagy a Küldés Gépház szakaszában.

  4. Az EDIFACT-szerződés szerkesztéséhez válassza ki a szerződést a Szerződések panelen. A Szerződések panel eszköztárán válassza a Szerkesztés JSON-ként lehetőséget.

    • A szerződés szakaszában receiveAgreement keresse meg a szakaszt schemaReferences , és adja hozzá az UNH2.5 értéket.

      Screenshot showing the Azure portal with an EDIFACT agreement's

    • A szerződés szakaszában sendAgreementkeresse meg a szakaszt schemaReferences , és adja hozzá az UNH2.5 értéket.

      Screenshot showing the Azure portal with an EDIFACT agreement's

További lépések