997 funkcionális visszaigazolások és hibakódok X12-üzenetekhez az Azure Logic Appsben
A következőkre vonatkozik: Azure Logic Apps (Használat + Standard)
Az Azure Logic Appsben X12-műveletek használatakor létrehozhat olyan munkafolyamatokat, amelyek X12-üzeneteket kezelnek az elektronikus adatcsere (EDI) kommunikációjához. Az EDI-üzenetküldésben a nyugták biztosítják az EDI-váltás feldolgozásának állapotát. Váltás fogadásakor az X12 Dekódolás művelet egy vagy több nyugtázási típust adhat vissza a feladónak, amely alapján a nyugtázási típusok engedélyezve vannak, és a megadott érvényesítési szint alapján.
A fogadó például egy 997-es funkcionális nyugtázás (ACK) és a feldolgozás során előforduló hibák elküldésével jelenti a funkcionális csoport fejlécének (GS) és a funkcionális csoport pótkocsijának (GE) ellenőrzésének állapotát a fogadott X12 kódolású üzenetben. Az X12 Dekódolás művelet mindig 4010-kompatibilis 997 ACK-t hoz létre, míg az X12 Kódolás művelet és az X12 Decode művelet egyaránt képes ellenőrizni az 5010-kompatibilis 997 ACK-t.
A fogadó elküldi a 997 ACK-t egy funkcionális csoportfejléc (GS) és funkcionáliscsoport-pótkocsi (GE) borítékon belül. Ez a GS- és GE-boríték azonban nem különbözik a többi tranzakcióhalmaztól.
Ez a témakör rövid áttekintést nyújt az X12 997 ACK-ről, beleértve a csomópont 997 ACK-szegmensét és az ezekben a szegmensekben használt hibakódokat. További kapcsolódó információkért tekintse át a következő dokumentációt:
- X12 TA1 műszaki visszaigazolások és hibakódok
- Exchange X12-üzenetek b2B vállalati integrációhoz
- Exchange EDIFACT-üzenetek b2B vállalati integrációhoz
- Mi az az Azure Logic Apps?
- B2B nagyvállalati integrációs megoldások az Azure Logic Apps és az Enterprise Integration Pack használatával
997 ACK-szegmensek
Az alábbi táblázat egy csomópont 997 ACK-szegmensét ismerteti, és a következő definíciókat használja:
- M = Kötelező
- O = Nem kötelező
| Pozíció | Szegmens azonosítója | Name | Kötelező megjelölés (Req. Des.) |
Maximális használat | Ismétlés ismétlése |
|---|---|---|---|---|---|
| 010 | ST | Tranzakciókészlet fejléce a nyugtázáshoz | M | 1 | - |
| 020 | AK1 | Funkcionális csoport válaszfejléce | M | 1 | - |
| 030 | AK2 | Tranzakciókészlet válaszfejléce | O | 1 | 999999 (Hurokazonosító = AK2) |
| 040 | AK3 | Adatszegmens megjegyzése | O | 1 | 999999 (Hurokazonosító = AK2 vagy AK3) |
| 050 | AK4 | Adatelem megjegyzése | O | 9 9 | - |
| 060 | AK5 | Tranzakciókészlet válaszelőzetese | M | 1 | - |
| 070 | AK9 | Funkcionális csoport válaszelőzetese | M | 1 | - |
| 080 | SE | Tranzakciókészlet előzetese a nyugtázáshoz | M | 1 | - |
Az alábbi szakaszok további információkat nyújtanak az egyes AK-szegmensekről. Az AK2–AK5 hurokban a szegmensek információt nyújtanak egy tranzakciókészlettel kapcsolatos hibáról.
AK1
A kötelező AK1-szegmens a következő adatelemek használatával azonosítja a nyugtázandó funkcionális csoportot:
| Elem | Leírás |
|---|---|
| AK101 | Kötelező, azonosítja a funkcionális csoport nyugtázandó funkcionális csoportazonosítóját (GS01). |
| AK102 | Kötelező, a funkcionális csoport nyugtázandó csoportvezérlőszámát (GS06 és GE02) azonosítja. |
| AK103 | Nem kötelező, azonosítja a GS08-ban az eredeti tranzakcióból a GS08-ban elküldött EDI-implementációs verziót. Az AK103 támogatja a bejövő 5010-kompatibilis 997 ACK-t. |
AK2
Az opcionális AK2 szegmens nyugtát tartalmaz a fogadott funkcionális csoportban beállított tranzakcióhoz. Ha több AK2-szegmens is létezik, a rendszer hurkok sorozataként küldi el őket. Minden AK2-hurok azonosít egy tranzakciókészletet a kapott rendeléssel. Ha egy tranzakciókészlet hibás, az AK2-hurkok AK3, AK4 és AK5 szegmenseket tartalmaznak. További információkért tekintse át a szakasz leírásait a jelen témakör későbbi részében.
Az AK2 szegmens a következő adatelemek használatával azonosítja a tranzakciókészletet:
| Elem | Leírás |
|---|---|
| AK201 | Kötelező, a nyugtázandó tranzakciókészlet azonosítóját (ST01) azonosítja. |
| AK202 | Kötelező, azonosítja a nyugtázandó tranzakciókészlet vezérlőszámát (ST02 és SE02). |
| AK203 | Nem kötelező, az eredeti tranzakció ST03-ban elküldött EDI-implementációs verzióját azonosítja. Az AK203 támogatja a bejövő 5010-kompatibilis 997-et. |
AK2-szegmensek létrehozása
Megadhatja, hogy az AK2-szegmensek az összes elfogadott és elutasított tranzakciókészlethez, vagy csak az elutasított tranzakciókészletekhez legyenek létrehozva. Ellenkező esetben az Azure Logic Apps csak elutasított tranzakciókészletekhez hoz létre AK2-hurkokat. Ha egy szerződés nem oldja fel a válaszban szereplő csomópontot, a 997-es generáció beállításai alapértelmezés szerint a tartalékszerződés beállításai, és az AK2-szegmensek nem jönnek létre elfogadott tranzakciókészletekhez.
Ha azt szeretné, hogy az Azure Logic Apps AK2-szegmenseket hozzon létre olyan elfogadott tranzakciókészletekhez, ahol az AK501 == A, kövesse az alábbi lépéseket:
A Azure Portal nyissa meg az integrációs fiókot, majd nyissa meg az X12-szerződés összetevőt az X12 kereskedelmi partnerei között.
Nyissa meg a Fogadási beállítások panelt, és győződjön meg arról, hogy a VÁRT ELEM megjelenik kiválasztva. Ezután kiválaszthatja az AK2/IK2 hurok belefoglalása lehetőséget.
AK3
Az opcionális AK3-szegmens egy adatszegmens hibáit jelenti, és azonosítja az adatszegmens helyét. Egy AK3-szegmens jön létre egy tranzakciókészlet minden olyan szegmenséhez, amely egy vagy több hibával rendelkezik. Ha több AK3-szegmens is létezik, a rendszer ciklusonként egy szegmenst tartalmazó ciklusok sorozataként küldi el őket. Az AK3-szegmens meghatározza az egyes szegmensek hibahelyét, és a következő adatelemek használatával jelenti az adott helyen található szintaktikai hiba típusát:
| Elem | Leírás |
|---|---|
| AK301 | Kötelező, az X12 szegmensazonosítóval (például NM1) azonosítja a hibás szegmenst. |
| AK302 | Kötelező, azonosítja a hibás szegmens szegmensszámát. Az ST szegmens a , 1és minden szegmens egyenként növeli a szegmensek számát. |
| AK303 | Kötelező, egy kötött hurkot azonosít, amely egy hurokkezdő (LS) szegmens és egy hurokvégi (LE) szegmens által körülvett hurok. Az AK303 azon LS- és LE-szegmensek értékeit tartalmazza, amelyek hiba miatt kötötték a szegmenst. |
| AK304 | Nem kötelező megadni a hiba kódját az adatszegmensben. Bár az AK304 nem kötelező, az elemre akkor van szükség, ha hiba van az azonosított szegmensben. Az AK304 hibakódjaiért tekintse át a 997 ACK-hibakódok – Adatszegmens megjegyzését. |
AK4
Az opcionális AK4-szegmens egy adatelem vagy összetett adatstruktúra hibáit jelenti, és azonosítja az adatelem helyét. Az AK4-szegmensek akkor lesznek elküldve, ha az AK304 adatelem az "8", "Segment has data element errors" , és akár 99-szer ismétlődhet az egyes AK3-szegmensek között. Az AK4-szegmens határozza meg az egyes adatelemek vagy összetett adatstruktúrák helyét a hibákban, és a következő adatelemek használatával jelenti az adott helyen található szintaktikai hiba típusát:
| Elem | Leírás |
|---|---|
| AK401 | Kötelező, összetett adatelem a következő mezőkkel: AK41.1, AK41.2 és AK41.3 - AK401.1: Azonosítja a hibás adatelemet vagy összetett adatstruktúrát a számszám alapján. Ha például a szegmens második adateleme hibával rendelkezik, az AK401 értéke . |
| AK402 | Nem kötelező, a hibaelem egyszerű X12 adatelemszámát azonosítja. Az NM101 például a 98-as számú egyszerű X12 adatelem. |
| AK403 | Kötelező, az azonosított elem hibáját jelenti. Az AK403 hibakódjaiért tekintse át a 997 ACK-hibakódok – Adatelem megjegyzését. |
| AK404 | Nem kötelező, a hibásan azonosított adatelem másolatát tartalmazza. Az AK404 nem használható, ha a hiba érvénytelen karaktert jelez. |
AK5
Az AK5 szegmens azt jelenti, hogy az AK2 szegmensben azonosított tranzakciókészletet elfogadják vagy elutasítják, és hogy miért. Az AK5 szegmens kötelező, ha az opcionális AK2 hurok szerepel a nyugtázásban. Az AK4-szegmens egyetlen kötelező adatelem használatával határozza meg a tranzakciókészlet állapotát, és hibakódokat biztosít egy-öt választható adatelem használatával a tranzakciókészlet szintaxisszerkesztése alapján.
| Elem | Leírás |
|---|---|
| AK501 | Kötelező, azt határozza meg, hogy az azonosított tranzakciókészletet elfogadják vagy elutasítják-e. Az AK501 hibakódjaiért tekintse át a 997 ACK-hibakódokat – Transaction Response Trailer című cikket. |
| AK502 – AK506 | Nem kötelező megadni a hiba természetét. Az AK502 hibakódjaiért tekintse át a 997 ACK-hibakódokat – Tranzakciókészlet válaszelőzetesét. |
AK9
A kötelező AK9-szegmens azt jelzi, hogy az AK1 szegmensben azonosított funkcionális csoport elfogadva vagy elutasítva van-e, és hogy miért. Az AK9 szegmens négy kötelező adatelem használatával határozza meg a tranzakciókészlet állapotát és a hibák jellegét. A szegmens a feljegyzett hibákat 1–5 választható elem használatával határozza meg.
| Elem | Leírás |
|---|---|
| AK901 | Kötelező, azt határozza meg, hogy az AK1-ben azonosított funkcionális csoport elfogadva vagy elutasítva legyen-e. Az AK901 hibakódjaiért tekintse át a 997 ACK-hibakódokat – Funkcionális csoport válaszelőzetesét. |
| AK902 | Kötelező, az azonosított funkcionális csoport pótkocsijában (GE01) szereplő tranzakciókészletek számát adja meg. |
| AK903 | Kötelező, a kapott tranzakciókészletek számát adja meg. |
| AK904 | Kötelező, az azonosított funkcionális csoportban elfogadott tranzakciókészletek számát adja meg. |
| AK905 – AK909 | Nem kötelező, az azonosított funkcionális csoportban észlelt egy-öt hibát jelez. Az AK905–AK909 hibakódok esetében tekintse át a 997 ACK-hibakódokat – Funkcionális csoport válaszelőzetesét. |
997 ACK-hibakódok
Ez a szakasz a 997 ACK-szegmensekben használt hibakódokat ismerteti. Minden tábla felsorolja az X12 specifikációban meghatározott támogatott és nem támogatott hibakódokat az Azure Logic Apps X12-üzenetfeldolgozásához.
AK304-hibakódok – Adatszegmens megjegyzése
Az alábbi táblázat az AK3 szegmens AK304 adatelemében használt hibakódokat sorolja fel (Adatszegmens megjegyzése):
| Hibakód | Feltétel | Támogatott? |
|---|---|---|
| 1 | Ismeretlen szegmensazonosító | Yes |
| 2 | Váratlan szegmens | Yes |
| 3 | Kötelező szegmens hiányzik | Yes |
| 4 | A hurok a maximális idő alatt fordul elő | Yes |
| 5 | A szegmens meghaladja a maximális használatot | Yes |
| 6 | A szegmens nincs definiált tranzakciókészletben | Yes |
| 7 | A szegmens nem megfelelő sorrendben | Yes |
| 8 | A szegmens adatelemhibákkal rendelkezik | Yes |
| 511 | Záró elválasztók (egyéni kód) | Yes |
AK403 hibakódok – Adatelem megjegyzése
Az alábbi táblázat az AK4 szegmens AK403 adatelemében használt hibakódokat sorolja fel (Adatelem megjegyzése):
| Hibakód | Feltétel | Támogatott? |
|---|---|---|
| 1 | Hiányzó kötelező adatelem | Yes |
| 2 | A feltételesen szükséges adatelem hiányzik | Yes |
| 3 | Túl sok adatelem | Yes |
| 4 | Az adatelem túl rövid | Yes |
| 5 | Az adatelem túl hosszú | Yes |
| 6 | Érvénytelen karakter az adatelemben | Yes |
| 7 | Érvénytelen kódérték | Yes |
| 8 | Érvénytelen dátum | Yes |
| 9 | Érvénytelen idő | Yes |
| 10 | A kizárási feltétel megsértve | Yes |
AK501 hibakódok – Tranzakciókészlet válaszelőzetese
Az alábbi táblázat az AK5 szegmens AK501 adatelemében (Transaction Set Response Trailer) használt hibakódokat sorolja fel:
| Hibakód | Feltétel | Támogatott? |
|---|---|---|
| A | Elfogadva | Yes |
| E | Elfogadva, de hiba történt | Yes Megjegyzés: Nincs olyan hibakód, amely a következő állapothoz |
| M | Elutasítva, az üzenethitelesítési kód (MAC) nem sikerült | No |
| P | Részben elfogadott, legalább egy tranzakciókészletet elutasítottak | Yes |
| R | Elutasítva | Yes |
| W | Elutasítva, a garancia nem felelt meg az érvényességi teszteknek | No |
| X | Elutasítva, a visszafejtést követő tartalom nem elemezhető | No |
AK502–AK506 hibakódok – Tranzakciókészlet válaszelőzetese
Az alábbi táblázat az AK5 szegmens AK502–AK506 adatelemeiben használt hibakódokat sorolja fel (Transaction Set Response Trailer):
| Hibakód | Feltétel | Támogatott vagy korrelál az AK501-zel? |
|---|---|---|
| 1 | A tranzakciókészlet nem támogatott | Igen, R |
| 2 | Hiányzó tranzakciókészlet-pótkocsi | Igen, R |
| 3 | A tranzakciókészlet vezérlőszáma a fejlécben és a pótkocsiban nem egyezik | Igen, R |
| 4 | A belefoglalt szegmensek száma nem egyezik a tényleges darabszámmal | Igen, R |
| 5 | Egy vagy több hibás szegmens | Igen, R |
| 6 | Hiányzó vagy érvénytelen tranzakciókészlet-azonosító | Igen, R |
| 7 | Hiányzó vagy érvénytelen tranzakciókészlet-vezérlőszám, ismétlődő tranzakciószám fordulhatott elő | Igen, R |
| 8–27 | - | No |
AK901 hibakódok – Funkcionális csoport válaszelőzetese
Az alábbi táblázat az AK9 szegmens AK901 adatelemeiben (funkcionáliscsoport-válaszelőzetes) használt hibakódokat sorolja fel:
| Hibakód | Feltétel | Támogatott vagy korrelál az AK501-zel? |
|---|---|---|
| A | Elfogadva | Yes |
| E | Elfogadva, de hiba történt | Yes |
| M | Elutasítva, az üzenethitelesítési kód (MAC) nem sikerült | No |
| P | Részben elfogadott, legalább egy tranzakciókészletet elutasítottak | Yes |
| R | Elutasítva | Yes |
| W | Elutasítva, a garancia nem felelt meg az érvényességi teszteknek | No |
| X | Elutasítva, a visszafejtést követő tartalom nem elemezhető | No |
AK905–AK909 hibakódok – Funkcionális csoport válaszelőzetese
Az alábbi táblázat az AK9 szegmens AK905–AK909 adatelemeiben (funkcionáliscsoport-válaszelőzetes) használt hibakódokat sorolja fel:
| Hibakód | Feltétel | Támogatott vagy korrelál az AK501-zel? |
|---|---|---|
| 1 | A funkcionális csoport nem támogatott | No |
| 2 | A funkcionális csoport verziója nem támogatott | No |
| 3 | A funkcionális csoport pótkocsija hiányzik | Yes |
| 4 | A funkcionális csoport fejlécében és utánfutójában lévő csoportvezérlő szám nem ért egyet | Yes |
| 5 | A belefoglalt tranzakciókészletek száma nem egyezik a tényleges számmal | Yes |
| 6 | A csoportvezérlő szám nem felel meg a szintaxisnak, előfordulhat, hogy ismétlődő csoportvezérlő szám történt | Yes |
| 7–26 | - | Nem |