مشاركة عبر

997 إقرار وظيفي ورموز خطأ لرسائل X12 في Azure Logic Apps

  • مقالة

ينطبق على: Azure Logic Apps (الاستهلاك + قياسي)

في Azure Logic Apps، يمكنك إنشاء مهام سير عمل تتعامل مع رسائل X12 لاتصالات تبادل البيانات الإلكترونية (EDI) عند استخدام عمليات X12. في رسائل EDI، توفر الإعلامات الحالة من معالجة تبادل EDI. عند تلقي تبادل، يمكن للإجراء X12 Decode إجراء إرجاع نوع واحد أو أكثر من إقرارات الاستلام إلى المرسل، بناءً على أنواع الإقرارات التي تم تمكينها والمستوى المحدد للتحقق.

على سبيل المثال، يُبلغ جهاز الاستقبال عن الحالة من التحقق من صحة رأس المجموعة الوظيفية (GS) ومقطورة المجموعة الوظيفية (GE) في الرسالة المستلمة بترميز X12 عن طريق إرسال إقرار وظيفي 997 (ACK) مع كل خطأ الذي يحدث أثناء المعالجة. يُنشئ إجراء فك ترميز X12 دائماً 997 ACK متوافقاً مع 4010، بينما يمكن لكل من الإجراءين X12 Encode وX12 Decode التحقق من صحة 5010 متوافق مع 997 ACK.

يرسل جهاز الاستقبال 997 ACK داخل مغلف لرأس المجموعة الوظيفية (GS) ومقطورة المجموعة الوظيفية (GE). ومع ذلك، لا يختلف مغلف GS وGE هذا عن أي مجموعة عمليات أخرى.

يقدم هذا الموضوع نظرة عامة مختصرة بشأن X12 997 ACK، بما في ذلك 997 مقاطع ACK في التبادل ورموز الخطأ المستخدمة في تلك المقاطع. للحصول على معلومات أخرى ذات صلة، راجع الوثائق التالية:

997 مقطع ACK

يصف الجدول التالي مقاطع 997 ACK في التبادل ويستخدم التعريفات التالية:

  • م = إلزامي
  • O = اختياري
‏‏الموضع معرف الجزء الاسم التعيين المطلوب
(متطلب. Des.)		 أقصى استخدام تكرار الحلقة
010 ST رأس مجموعة العمليات، للإقرار M 1 -
020 AK1 رأس استجابة المجموعة الوظيفية M 1 -
030 AK2 رأس استجابة مجموعة العمليات -O 1 999999
(معرف الحلقة = AK2)
040 AK3 ملاحظة قطاع البيانات -O 1 999999
(معرف الحلقة = AK2 أو AK3)
050 AK4 ملاحظة عنصر البيانات -O 9 9 -
060 AK5 المقطع الدعائي لاستجابة مجموعة العمليات M 1 -
070 AK9 مقطورة استجابة المجموعة الوظيفية M 1 -
080 حد ذاته مقطورة مجموعة العمليات، للإقرار M 1 -

توفر الأقسام التالية مزيداً من المعلومات بشأن كل مقطع AK. في حلقة AK2 إلى AK5، توفر المقاطع معلومات بشأن خطأ في مجموعة العمليات.

AK1

يحدد مقطع AK1 الإلزامي المجموعة الوظيفية التي يجب الاعتراف بها باستخدام عناصر البيانات التالية:

العنصر الوصف
AK101 إلزامي، يحدد معرف المجموعة الوظيفية (GS01) للمجموعة الوظيفية للإقرار به.
AK102 إلزامي، يحدد رقم التحكم في المجموعة (GS06 وGE02) للمجموعة الوظيفية للاعتراف بها.
AK103 اختياري، يحدد إصدار تنفيذ EDI للبيانات المرسلة في GS08 من العملية الأصلية. يدعم AK103 الوارد المتوافق مع 997 ACK 5010.

AK2

يحتوي مقطع AK2 الاختياري على إقرار بعملية معينة في المجموعة الوظيفية المستلمة. في حالة وجود عدة مقاطع AK2، يتم إرسالها كسلسلة من الحلقات. تحدد كل حلقة AK2 مجموعة عملية باستخدام الأمر المستلم. إذا كانت مجموعة العمليات خاطئة، فإن حلقة AK2 تحتوي على مقاطع AK3 وAK4 وAK5. لمزيد من المعلومات، راجع أوصاف المقطع لاحقاً في هذا الموضوع.

يحدد مقطع AK2 العملية التي تم تعيينها باستخدام عناصر البيانات التالية:

العنصر الوصف
AK201 إلزامي، يحدد معرف مجموعة العمليات (ST01) للعملية التي تم تعيينها للإقرار.
AK202 إلزامي، يحدد رقم التحكم في مجموعة العملية (ST02 وSE02) للعملية التي تم تعيينها للإقرار.
AK203 اختياري، يحدد إصدار تنفيذ EDI للبيانات المرسلة في ST03 للعملية الأصلية. يدعم جهاز AK203 997 المتوافق مع 5010 الوارد.

إنشاء مقاطع AK2

يمكنك تحديد إنشاء شرائح AK2 all مجموعات العمليات المقبولة والمرفوضة، أو only لمجموعات العمليات المرفوضة. بخلاف ذلك، تنشئ Azure Logic Apps حلقات AK2 only لمجموعات العمليات المرفوضة. إذا لم يتم حل الاتفاقية للتبادل الذي تتم الاستجابة له، فإن إعدادات إنشاء 997 افتراضياً لإعدادات الاتفاقية الاحتياطية، ولا يتم إنشاء مقاطع AK2 لمجموعات العمليات المقبولة.

لجعل Azure Logic Apps تنشئ مقاطع AK2 لمجموعات العمليات المقبولة حيث AK501 == A، اتبع الخطوات التالية:

  1. في مدخل Microsoft Azure، افتح حساب التكامل الخاص بك، ثم افتح عنصر اتفاقية X12 بين شركائك التجاريين X12.

  2. افتح جزء Receive Settings، وتأكد من ظهور تحديد FA Expected. يمكنك بعد ذلك تحديد Include AK2/IK2 Loop.

AK3

تبلغ شريحة AK3 الاختيارية عن أخطاء في مقطع بيانات وتحدد موقع مقطع البيانات. يتم إنشاء مقطع AK3 لكل مقطع في مجموعة العمليات التي بها خطأ واحد أو أكثر. في حالة وجود عدة مقاطع AK3، يتم إرسالها كسلسلة من الحلقات مع جزء واحد لكل حلقة. يحدد مقطع AK3 موقع كل جزء به خطأ ويبلغ عن نوع الخطأ النحوي الموجود في ذلك الموقع باستخدام عناصر البيانات التالية:

العنصر الوصف
AK301 إلزامي، يحدد القطعة التي بها خطأ مع معرف مقطع X12، على سبيل المثال، NM1.
AK302 إلزامي، يحدد عدد المقاطع التي بها خطأ. المقطع ST هو 1، ويزيد كل مقطع عدد المقاطع بمقدار واحد.
AK303 إلزامي، يحدد حلقة محددة، وهي حلقة محاطة بمقطع حلقة البدء (LS) ومقطع حلقة النهاية (LE). يحتوي AK303 على قيم LS وLE المقاطع التي تربط المقطع بالخطأ.
AK304 اختياري، يحدد تعليمة برمجية الخطأ في مقطع البيانات. رغم أن جهاز AK304 اختياري، إلا إن العنصر مطلوب عند وجود خطأ في المقطع المحدد. بالنسبة إلى رموز خطأ AK304، راجع رموز خطأ 997 ACK - ملاحظة قطاع البيانات.

AK4

يُبلغ مقطع AK4 الاختياري عن أخطاء في عنصر البيانات أو بنية البيانات المركبة، ويحدد موقع عنصر البيانات. يتم إرسال مقطع AK4 عندما يكون عنصر بيانات AK304 "8", "Segment has data element errors" ويمكن أن يتكرر حتى 99 مرة داخل كل مقطع AK3. يحدد مقطع AK4 موقع كل عنصر بيانات أو بنية بيانات مركبة في الخطأ ويبلغ عن نوع الخطأ النحوي الموجود في ذلك الموقع باستخدام عناصر البيانات التالية:

العنصر الوصف
AK401 عنصر بيانات مركب إلزامي مع الحقول التالية: AK41.1 وAK41.2 وAK41.3

- AK401.1: يحدد خطأ عنصر البيانات أو بنية البيانات المركبة باستخدام العد العددي. على سبيل المثال، إذا كان عنصر البيانات الثاني في المقطع به خطأ، فإن AK401 يساوي 2.
AK401.2: يحدد العد العددي لعنصر بيانات المكون في بنية بيانات مركبة بها خطأ. عندما يبلغ AK401 عن خطأ في بنية بيانات غير مركبة، لا يتم تقييم AK401.2.
- AK41.3: اختياري، هذا الحقل هو موضع عنصر البيانات المتكرر. يدعم AK41.3 الوارد المتوافق مع 5010 -997.
AK402 اختياري، يحدد رقم عنصر بيانات X12 البسيط للعنصر الخاطئ. على سبيل المثال، NM101 هو عنصر بيانات X12 البسيط رقم 98.
AK403 إلزامي، يُبلغ عن خطأ العنصر المحدد. بالنسبة إلى رموز الخطأ AK403، راجع رموز خطأ 997 ACK - ملاحظة عنصر البيانات.
AK404 اختياري، يحتوي على نسخة من عنصر البيانات المحدد بالخطأ. لا يتم استخدام AK404 إذا كان الخطأ يشير إلى حرف غير صالح.

AK5

يوضح مقطع AK5 ما إذا كانت مجموعة العمليات المحددة في مقطع AK2 مقبولة أو مرفوضة ولماذا. يعتبر جزء AK5 إلزامياً عندما يتم تضمين حلقة AK2 الاختيارية في الإقرار. يحدد مقطع AK4 حالة مجموعة العمليات باستخدام عنصر بيانات إلزامي واحد ويوفر رموز خطأ باستخدام ما بين عنصر واحد إلى خمسة عناصر بيانات اختيارية، بناءً على تحرير بناء الجملة لمجموعة العمليات.

العنصر الوصف
AK501 إلزامي، يحدد ما إذا كانت مجموعة العمليات المحددة مقبولة أو مرفوضة. بالنسبة إلى رموز خطأ AK501، راجع رموز خطأ 997 ACK - المقطع الدعائي لاستجابة العملية.
AK502 - AK506 اختياري، حدد طبيعة الخطأ. بالنسبة إلى رموز خطأ AK502، راجع رموز خطأ 997 ACK - المقطع الدعائي لاستجابة مجموعة العمليات.

AK9

يشير مقطع AK9 الإلزامي إلى ما إذا كانت المجموعة الوظيفية المحددة في مقطع AK1 مقبولة أو مرفوضة ولماذا. يحدد مقطع AK9 حالة مجموعة العمليات وطبيعة أي خطأ باستخدام أربعة عناصر بيانات إلزامية. يحدد المقطع أي أخطاء ملحوظة باستخدام ما بين عنصر واحد إلى خمسة عناصر اختيارية.

العنصر الوصف
AK901 إلزامي، يحدد ما إذا كانت المجموعة الوظيفية المحددة في AK1 مقبولة أو مرفوضة. بالنسبة لرموز خطأ AK901، راجع رموز خطأ 997 ACK - المقطع الدعائي لاستجابة المجموعة الوظيفية.
AK902 إلزامي، يحدد عدد مجموعات العمليات المضمنة في مقطورة المجموعة الوظيفية المحددة (GE01).
AK903 إلزامي، يحدد عدد مجموعات العمليات المستلمة.
AK904 إلزامي، يحدد عدد مجموعات العمليات المقبولة في المجموعة الوظيفية المحددة.
AK905 - AK909 اختياري، يشير إلى خطأ واحد إلى خمسة أخطاء تم ملاحظتها في المجموعة الوظيفية المحددة. بالنسبة إلى رموز الخطأ من AK905 إلى AK909، راجع رموز خطأ 997 ACK - مقطورة استجابة المجموعة الوظيفية.

997 رموز خطأ ACK

يغطي هذا القسم رموز الخطأ المستخدمة في 997 مقطع ACK. يسرد كل جدول رموز الخطأ المدعومة وغير المدعومة، على النحو المحدد في مواصفات X12، لمعالجة رسائل X12 في Azure Logic Apps.

رموز خطأ AK304 - ملاحظة قطاع البيانات

يسرد الجدول التالي رموز الخطأ المستخدمة في عنصر بيانات AK304 لشريحة AK3 (ملاحظة جزء البيانات):

رمز الخطأ الشرط مدعومة؟
1 معرف شريحة غير معروف نعم
2 جزء غير متوقع نعم
3 المقطع الإلزامي مفقود نعم
4 تحدث التكرار خلال أوقات قصوى نعم
5 تجاوز المقطع الحد الأقصى للاستخدام نعم
6 المقطع ليس في مجموعة عمليات محددة نعم
7 المقطع ليس في التسلسل الصحيح نعم
8 الجزء به أخطاء في عنصر البيانات نعم
511 تمت مصادفة فواصل زائدة (تعليمة برمجية مخصص) نعم

رموز خطأ AK403 - ملاحظة عنصر البيانات

يسرد الجدول التالي رموز الخطأ المستخدمة في عنصر بيانات AK403 لشريحة AK4 (ملاحظة عنصر البيانات):

رمز الخطأ الشرط مدعومة؟
1 عنصر البيانات الإلزامي مفقود نعم
2 عنصر البيانات المطلوب الشرطي مفقود نعم
3 عناصر بيانات كثيرة جداً نعم
4 عنصر البيانات قصير جداً نعم
5 عنصر البيانات طويل جداً نعم
6 حرف غير صالح في عنصر البيانات نعم
7 قيمة تعليمة برمجية غير صالحة نعم
8 تاريخ غير صالح نعم
9 الوقت غير صحيح نعم
10 انتهاك شرط الاستبعاد نعم

رموز خطأ AK501 - مقطورة استجابة مجموعة العمليات

يسرد الجدول التالي رموز الخطأ المستخدمة في عنصر بيانات AK501 لشريحة AK5 (مقطورة استجابة مجموعة العمليات):

رمز الخطأ الشرط مدعومة؟
A مقبول نعم
E مقبولة ولكن تم تسجيل الأخطاء نعم

ملاحظة: لا توجد رموز خطأ تؤدي إلى الحالة E.
M تم الرفض، فشل تعليمة برمجية مصادقة الرسالة (MAC) لا
P تم قبولها جزئياً، وتم رفض مجموعة عمليات واحدة على الأقل نعم
R مرفوض وغير موافق عليه نعم
W مرفوض، فشل التأكيد في اختبارات الصلاحية لا
X مرفوض، المحتوى بعد فك التشفير لا يمكن تحليله لا

رموز الخطأ من AK502 إلى AK506 - مقطورة استجابة مجموعة العمليات

يسرد الجدول التالي رموز الخطأ المستخدمة في عناصر بيانات AK502 إلى AK506 لشريحة AK5 (مقطورة استجابة مجموعة العمليات):

رمز الخطأ الشرط المدعومة أو
مرتبط بـ AK501؟
1 مجموعة العمليات غير مدعومة نعم، ر
2 المقطع الدعائي لمجموعة العمليات مفقود نعم، ر
3 رقم التحكم في مجموعة العمليات في الرأس والمقطورة غير متطابقين نعم، ر
4 عدد الشرائح المضمنة لا يتطابق مع العدد الفعلي نعم، ر
5 جزء واحد أو أكثر في الخطأ نعم، ر
6 معرّف مجموعة العمليات مفقود أو غير صالح نعم، ر
7 رقم التحكم في مجموعة العمليات مفقود أو غير صالح، ربما حدث رقم عملية مكرر نعم، ر
من 8 إلى 27 - لا

رموز خطأ AK901 - مقطورة استجابة المجموعة الوظيفية

يسرد الجدول التالي رموز الخطأ المستخدمة في عناصر بيانات AK901 لشريحة AK9 (مقطورة استجابة المجموعة الوظيفية):

رمز الخطأ الشرط المدعومة أو
مرتبط بـ AK501؟
A مقبول نعم
E مقبولة، ولكن تم تسجيل الأخطاء نعم
M تم الرفض، فشل تعليمة برمجية مصادقة الرسالة (MAC) لا
P تم قبولها جزئياً، وتم رفض مجموعة عمليات واحدة على الأقل نعم
R مرفوض وغير موافق عليه نعم
W مرفوض، فشل التأكيد في اختبارات الصلاحية لا
X مرفوض، المحتوى بعد فك التشفير لا يمكن تحليله لا

رموز الخطأ من AK905 إلى AK909 - مقطورة استجابة المجموعة الوظيفية

يسرد الجدول التالي رموز الخطأ المستخدمة في عناصر البيانات من AK905 إلى AK909 لقطاع AK9 (مقطورة استجابة المجموعة الوظيفية):

رمز الخطأ الشرط المدعومة أو
مرتبط بـ AK501؟
1 المجموعة الوظيفية غير مدعومة لا
2 إصدار المجموعة الوظيفية غير مدعوم لا
3 مقطورة المجموعة الوظيفية مفقودة نعم
4 رقم التحكم في المجموعة في رأس المجموعة الوظيفية والمقطورة غير موافقين نعم
5 عدد مجموعات العمليات المضمنة لا يتطابق مع العدد الفعلي نعم
6 رقم التحكم في المجموعة ينتهك بناء الجملة، وربما حدث رقم تحكم مجموعة مكرر نعم
من 7 إلى 26 - لا

الخطوات التالية