مشاركة عبر

مرجع لإعدادات رسائل X12 في اتفاقيات Azure Logic Apps

  • مقالة

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

يصف هذا المرجع الخصائص التي يمكنك تعيينها في اتفاقية X12 لتحديد كيفية التعامل مع الرسائل بين الشركاء التجاريين. قم بإعداد هذه الخصائص استنادًا إلى اتفاقيتك مع الشريك الذي يتبادل الرسائل معك.

إعدادات تلقي X12

لقطة شاشة تعرض مدخل Microsoft Azure وإعدادات اتفاقية X12 للرسائل الواردة.

معرفات

الخاصية الوصف
ISA1 (Authorization Qualifier) قيمة مؤهل التخويل التي تريد استخدامها. القيمة الافتراضية هي 00 - No Authorization Information Present.

ملاحظة: إذا حددت قيماً أخرى، فحدد قيمة للخاصية ISA2.
ISA2 قيمة معلومات التخويل لاستخدامها عندما تكون الخاصية ISA1 ليست 00 - No Authorization Information Present. يجب أن تحتوي قيمة الخاصية هذه على حرف أبجدي رقمي واحد كحد أدنى و10 كحد أقصى.
ISA3 (Security Qualifier) قيمة مؤهل الأمان التي تريد استخدامها. القيمة الافتراضية هي 00 - No Security Information Present.

ملاحظة: إذا حددت قيماً أخرى، فحدد قيمة للخاصية ISA4.
ISA4 قيمة معلومات الأمان لاستخدامها عندما تكون الخاصيةISA3 ليست 00 - No Security Information Present. يجب أن تحتوي قيمة الخاصية هذه على حرف أبجدي رقمي واحد كحد أدنى و10 كحد أقصى.

إقرار

الخاصية الوصف
TA1 Expected إرجاع إقرار تقني (TA1) إلى مرسل التبادل.
FA Expected إرجاع إقرار وظيفي (FA) إلى مرسل التبادل.

بالنسبة لخاصية FA Version، استناداً إلى إصدار المخطط، حدد الإقرارات 997 أو 999.

لتمكين إنشاء تكرار حلقي AK2 في الإقرارات الوظيفية لمجموعات العمليات المقبولة، حدد "Include AK2 / IK2 Loop".

المخططات

في هذا القسم، حدد "schema" من حساب التكامل الخاص بك لكل نوع معاملة (ST01) وتطبيق المرسل (GS02). يقوم EDI Receive Pipeline بتفكيك الرسالة الواردة عن طريق مطابقة القيم والمخطط الذي عينته في هذا القسم بقيم ST01 وGS02 في الرسالة الواردة مع مخطط الرسالة الواردة. بعد إكمال كل صف، يظهر صف فارغ جديد تلقائياً.

الخاصية الوصف
إصدار إصدار X12 للمخطط
Transaction Type (ST01) نوع العملية
Sender Application (GS02) تطبيق المرسل
المخطط ملف المخطط الذي تريد استخدامه

مغلفات

الخاصية الوصف
ISA11 Usage الفاصل الذي يجب استخدامه في مجموعة عمليات:

- Standard Identifier: استخدم نقطة (.) للعلامة العشرية، بدلاً من العلامة العشرية للمستند الوارد في مسار تلقي EDI.

- Repetition Separator: يُحدد الفاصل للتكرارات المتكررة لعنصر بيانات بسيط أو بنية بيانات متكررة. على سبيل المثال، عادة ما يتم استخدام قيراط (^) كفاصل التكرار. بالنسبة لمخططات HIPAA، يمكنك فقط استخدام قيراط.

أرقام التحكم

الخاصية الوصف
Disallow Interchange control number duplicates منع تبادلات التكرار. تحقق من رقم عنصر تحكم التبادل (ISA13) لرقم عنصر تحكم التبادل المستلم. إذا تم الكشف عن تطابق، فإن EDI Receive Pipeline لا يعالج التبادل.



لتحديد عدد الأيام لإجراء الفحص، أدخل قيمة للخاصية Check for duplicate ISA13 every (days).
Disallow Group control number duplicates منع تداخلات تحتوي على أرقام عناصر تحكم مجموعة مكررة.
Disallow Transaction set control number duplicates منع تداخلات تحتوي على أرقام عناصر تحكم مجموعة عمليات مكررة.

التصديقات

يعرض الصف Default قواعد التحقق من الصحة المستخدمة لنوع رسالة EDI. إذا كنت تريد تعريف قواعد مختلفة، فحدد كل مربع تريد تعيين القاعدة فيه إلى "true". بعد إكمال كل صف، يظهر صف فارغ جديد تلقائياً.

الخاصية الوصف
Message Type نوع رسالة EDI
EDI Validation إجراء التحقق من صحة EDI على أنواع البيانات كما هو محدد بواسطة خصائص مخطط EDI وقيود الطول وعناصر البيانات الفارغة والفواصل اللاحقة.
Extended Validation إذا كان نوع البيانات ليس EDI، فإن التحقق من الصحة على متطلبات عنصر البيانات والتكرار المسموح به وقائمة التعداد والتحقق من طول عنصر البيانات (الحد الأدنى أو الحد الأقصى).
Allow Leading/Trailing Zeroes الاحتفاظ بأي أحرف مسافة إضافية بادئة أو لاحقة للصفر. لا تُزِل هذه الأحرف.
Trim Leading/Trailing Zeroes إزالة أي أحرف مسافة بادئة أو لاحقة للصفر.
Trailing Separator Policy إنشاء فواصل لاحقة.

- Not Allowed: حظر المحدّدات اللاحقة والفواصل في التبادل الوارد. إذا كان التبادل يحتوي على محددات وفواصل لاحقة، يُعلن عن أن التبادل غير صالح.

- Optional: قبول التداخلات مع المحدّدات اللاحقة والفواصل أو دونها.

- Mandatory: يجب أن يحتوي التبادل الوارد على محدّدات لاحقة وفواصل.

الإعدادات الداخلية

الخاصية الوصف
Convert implied decimal format Nn to a base 10 numeric value تحويل رقم EDI المُحدد بالتنسيق "Nn" إلى قيمة رقمية أساسية 10.
Create empty XML tags if trailing separators are allowed اجعل مرسل التبادل يتضمن علامات XML فارغة للفواصل اللاحقة.
Split Interchange as transaction sets - suspend transaction sets on error توزيع كل عملية تم تعيينها في تبادل في مستند XML منفصل عن طريق تطبيق المغلف المناسب على مجموعة العمليات. إيقاف المعاملات مؤقتاً فقط حيث يفشل التحقق من الصحة.
Split Interchange as transaction sets - suspend interchange on error توزيع كل عملية تم تعيينها في تبادل في مستند XML منفصل عن طريق تطبيق المغلف المناسب. أوقف التبادل بأكمله مؤقتاً عندما تقوم مجموعة عملية واحدة أو أكثر في التحقق من فشل التبادل.
Preserve Interchange - suspend transaction sets on error اترك التبادل سليماً، وأنشئ مستند XML للتبادل المجمع بالكامل. أوقف مجموعات العمليات التي تفشل في التحقق من الصحة فقط، لكن استمر في معالجة جميع مجموعات العمليات الأخرى.
Preserve Interchange - suspend interchange on error يترك التبادل سليماً، وينشئ مستند XML للتبديل المجمع بالكامل. تعليق التبادل بأكمله عند مجموعة عملية واحدة أو أكثر في التحقق من فشل تبادل البيانات.

إعدادات إرسال X12

لقطة شاشة تعرض مدخل Microsoft Azure وإعدادات اتفاقية X12 للرسائل الصادرة.

معرفات

الخاصية الوصف
ISA1 (Authorization Qualifier) قيمة مؤهل التخويل التي تريد استخدامها. القيمة الافتراضية هي 00 - No Authorization Information Present.

ملاحظة: إذا حددت قيماً أخرى، فحدد قيمة للخاصية ISA2.
ISA2 قيمة معلومات التخويل لاستخدامها عندما تكون الخاصية ISA1 ليست 00 - No Authorization Information Present. يجب أن تحتوي قيمة الخاصية هذه على حرف أبجدي رقمي واحد كحد أدنى و10 كحد أقصى.
ISA3 (Security Qualifier) قيمة مؤهل الأمان التي تريد استخدامها. القيمة الافتراضية هي 00 - No Security Information Present.

ملاحظة: إذا حددت قيماً أخرى، فحدد قيمة للخاصية ISA4.
ISA4 قيمة معلومات الأمان لاستخدامها عندما تكون الخاصيةISA3 ليست 00 - No Security Information Present. يجب أن تحتوي قيمة الخاصية هذه على حرف أبجدي رقمي واحد كحد أدنى و10 كحد أقصى.

إقرار

الخاصية الوصف
TA1 Expected إرجاع إقرار تقني (TA1) إلى مرسل التبادل.

يُحدد هذا الإعداد أن الشريك المضيف، الذي يرسل الرسالة، يطلب إقراراً من الشريك الضيف في الاتفاقية. يتوقع الشريك المضيف هذه الإقرارات استناداً إلى إعدادات تلقي الاتفاقية.
FA Expected إرجاع إقرار وظيفي (FA) إلى مرسل التبادل. بالنسبة لخاصية FA Version، استناداً إلى إصدار المخطط، حدد الإقرارات 997 أو 999.

يُحدد هذا الإعداد أن الشريك المضيف، الذي يرسل الرسالة، يطلب إقراراً من الشريك الضيف في الاتفاقية. يتوقع الشريك المضيف هذه الإقرارات استناداً إلى إعدادات تلقي الاتفاقية.

المخططات

في هذا القسم، حدد "schema" من حساب التكامل الخاص بك لكل نوع معاملة (ST01). بعد إكمال كل صف، يظهر صف فارغ جديد تلقائياً.

الخاصية الوصف
إصدار إصدار X12 للمخطط
Transaction Type (ST01) نوع العملية للمخطط
المخطط ملف المخطط الذي تريد استخدامه. إذا حددت المخطط أولاً، فيتم تعيين الإصدار ونوع العملية تلقائياً.

مغلفات

الخاصية الوصف
ISA11 Usage الفاصل الذي يجب استخدامه في مجموعة عمليات:

- Standard Identifier: استخدم نقطة (.) للعلامة العشرية، بدلاً من العلامة العشرية للمستند الصادر في مسار إرسال EDI.

- Repetition Separator: يُحدد الفاصل للتكرارات المتكررة لعنصر بيانات بسيط أو بنية بيانات متكررة. على سبيل المثال، عادة ما يتم استخدام قيراط (^) كفاصل التكرار. بالنسبة لمخططات HIPAA، يمكنك فقط استخدام قيراط.

Control Version Number

في هذا القسم، حدد "schema" من حساب التكامل الخاص بك لكل تبادل. بعد إكمال كل صف، يظهر صف فارغ جديد تلقائياً.

الخاصية الوصف
Control Version Number (ISA12) إصدار X12 القياسي
Usage Indicator (ISA15) سياق تبادل، وهو إما بيانات الاختبار، أو بيانات المعلومات أو بيانات الإنتاج
المخطط المخطط المراد استخدامه لإنشاء مقاطع GS وST للتبادل المشفر X12 الذي يتم إرساله إلى مسار إرسال EDI.
GS1 اختياري، حدد التعليمات البرمجية الوظيفية.
GS2 اختياري، حدد مرسل التطبيق.
GS3 اختياري، حدد مُستقبل التطبيق.
GS4 اختياري، حدد "CCYYMMDD" أو "YYMMDD".
GS5 اختياري، حدد "HHMM" أو "HHMMSS" أو "HHMMSSd".
GS7 اختياري، حدد قيمة للوكالة المسؤولة.
GS8 اختياري، حدد إصدار مستند المخطط.

أرقام التحكم

الخاصية الوصف
Interchange Control Number (ISA13) نطاق القيم لرقم عنصر تحكم التبادل، والذي يمكن أن يكون له قيمة 1 كحد أدنى وقيمة قصوى 999999999
Group Control Number (GS06) نطاق القيم لرقم عنصر تحكم المجموعة، والذي يمكن أن يكون له قيمة 1 كحد أدنى وقيمة قصوى 999999999
Transaction Set Control Number (ST02) نطاق القيم لرقم عنصر تحكم مجموعة العملية، والذي يمكن أن يكون له قيمة 1 كحد أدنى وقيمة قصوى 999999999

- Prefix: اختيارية، قيمة أبجدية رقمية
- Suffix: اختيارية، قيمة أبجدية رقمية

مجموعات الأحرف والفواصل

يعرض الصف Default مجموعة الأحرف المستخدمة كمحدّدات لمخطط رسالة. إذا كنت لا تريد استخدام مجموعة الأحرف الافتراضية، فيمكنك إدخال مجموعة مختلفة من المحدّدات لكل نوع رسالة. بعد إكمال كل صف، يظهر صف فارغ جديد تلقائياً.

تلميح

لتوفير قيم أحرف خاصة، قم بتحرير الاتفاقية كـ JSON وتوفير قيمة ASCII للحرف الخاص.

الخاصية الوصف
Character Set to be used مجموعة أحرف X12، وهي إما Basic أو Extended أو UTF8.
المخطط المخطط الذي تريد استخدامه. بعد تحديد المخطط، حدد مجموعة الأحرف التي تريد استخدامها، استناداً إلى أوصاف الفاصل أدناه.
Input Type نوع الإدخال لمجموعة الأحرف
Component Separator حرف واحد يفصل بين عناصر البيانات المركبة
Data Element Separator حرف واحد يفصل بين عناصر البيانات البسيطة داخل البيانات المركبة
فاصل أحرف الاستبدال حرف بديل يحل محل جميع الأحرف الفاصلة في البيانات الأساسية عند إنشاء رسالة X12 الصادرة
Segment Terminator حرف واحد يشير إلى نهاية مقطع EDI
اللاحقة الحرف الذي يجب استخدامه مع معرف المقطع. إذا حددت لاحقة، فيمكن أن يكون عنصر بيانات القطعة فارغاً. إذا تُركَ فاصل المقطع فارغاً، فيجب تعيين لاحقة.

التحقق من الصحة

يعرض الصف Default قواعد التحقق من الصحة المستخدمة لنوع رسالة EDI. إذا كنت تريد تعريف قواعد مختلفة، فحدد كل مربع تريد تعيين القاعدة فيه إلى "true". بعد إكمال كل صف، يظهر صف فارغ جديد تلقائياً.

الخاصية الوصف
Message Type نوع رسالة EDI
EDI Validation إجراء التحقق من صحة EDI على أنواع البيانات كما هو محدد بواسطة خصائص مخطط EDI وقيود الطول وعناصر البيانات الفارغة والفواصل اللاحقة.
Extended Validation إذا كان نوع البيانات ليس EDI، فإن التحقق من الصحة على متطلبات عنصر البيانات والتكرار المسموح به وقائمة التعداد والتحقق من طول عنصر البيانات (الحد الأدنى أو الحد الأقصى).
Allow Leading/Trailing Zeroes الاحتفاظ بأي أحرف مسافة إضافية بادئة أو لاحقة للصفر. لا تُزِل هذه الأحرف.
Trim Leading/Trailing Zeroes إزالة أي أحرف مسافة بادئة أو لاحقة للصفر.
Trailing Separator Policy إنشاء فواصل لاحقة.

- Not Allowed: حظر المحدّدات اللاحقة والفواصل في التبادل الصادر. إذا كان التبادل يحتوي على محددات وفواصل لاحقة، يُعلن عن أن التبادل غير صالح.

- Optional: إرسال تبادلات مع محدّدات وفواصل لاحقة أو دونها.

- Mandatory: يجب أن يحتوي التبادل الصادر على محدّدات لاحقة وفواصل.

مخططات HIPAA وأنواع الرسائل

عند العمل مع مخططات HIPAA وأنواع الرسائل 277 أو 837، تحتاج إلى تنفيذ بعض الخطوات الإضافية. تحتوي أرقام إصدارات المستند (GS8) لهذه الأنواع من الرسائل على أكثر من تسعة أحرف، على سبيل المثال، "005010X222A1". علاوة على ذلك، تُعيّن بعض أرقام إصدارات المستندات إلى أنواع رسائل متغيرة. إذا لم تُشِر إلى نوع الرسالة الصحيح في المخطط وفي اتفاقيتك، فستتلقى رسالة الخطأ هذه:

"The message has an unknown document type and did not resolve to any of the existing schemas configured in the agreement."

يسرد هذا الجدول أنواع الرسائل المتأثرة وأي متغيرات وأرقام إصدارات المستند التي تعين أنواع الرسائل هذه:

نوع الرسالة أو المتغير الوصف رقم إصدار المستند (GS8)
277 إخطار حالة معلومات الرعاية الصحية 005010X212
837_I المطالبة بالرعاية الصحية المؤسسية 004010X096A1
005010X223A1
005010X223A2
837_D المطالبة بالرعاية الصحية للأسنان 004010X097A1
005010X224A1
005010X224A2
837_P المطالبة بالرعاية الصحية المهنية 004010X098A1
005010X222
005010X222A1

تحتاج أيضاً إلى تعطيل التحقق من صحة EDI عند استخدام أرقام إصدارات المستند هذه لأنها تؤدي إلى خطأ في أن طول الحرف غير صحيح.

لتحديد أرقام إصدارات المستند وأنواع الرسائل هذه، اتبع الخطوات التالية:

  1. في مخطط HIPAA، استبدل نوع الرسالة الحالي بنوع الرسالة المتغير لرقم إصدار المستند الذي تريد استخدامه.

    على سبيل المثال، افترض أنك تريد استخدام رقم إصدار المستند 005010X222A1 مع نوع الرسالة 837. في المخطط الخاص بك، استبدل كل قيمة "X12_00501_837" بالقيمة "X12_00501_837_P" بدلاً من ذلك.

    لتحديث المخطط الخاص بك اتبع الخطوات التالية:

    1. في مدخل Microsoft Azure، انتقل إلى حساب التكامل الخاص بك. ابحث عن المخطط وقم بتنزيله. استبدل نوع الرسالة وأعد تسمية ملف المخطط، وحمّل المخطط الذي تمت مراجعته إلى حساب التكامل الخاص بك. لمزيد من المعلومات، راجع تحرير مخطط.

    2. في إعدادات رسالة الاتفاقية، حدد المخطط الذي تمت مراجعته.

  2. في عنصر الاتفاقية schemaReferences، أضف إدخالاً آخر يُحدد نوع الرسالة المتغير الذي يتطابق مع رقم إصدار المستند.

    على سبيل المثال، افترض أنك تريد استخدام رقم إصدار المستند 005010X222A1 لنوع الرسالة 837. تحتوي الاتفاقية على قسم schemaReferences بهذه الخصائص والقيم:

    "schemaReferences": [
   {
      "messageId": "837",
      "schemaVersion": "00501",
      "schemaName": "X12_00501_837"
   }
]

    في هذا القسم schemaReferences، أضف إدخالا آخر يحتوي على هذه القيم:

    • "messageId": "837_P"
    • "schemaVersion": "00501"
    • "schemaName": "X12_00501_837_P"

    عند الانتهاء، يبدو القسم الخاص بك schemaReferences كما يلي:

    "schemaReferences": [
   {
      "messageId": "837",
      "schemaVersion": "00501",
      "schemaName": "X12_00501_837"
   },
   {
      "messageId": "837_P",
      "schemaVersion": "00501",
      "schemaName": "X12_00501_837_P"
   }
]

  3. في إعدادات رسالة الاتفاقية، عطّل التحقق من صحة EDI عن طريق مسح خانة الاختيار "EDI Validation" إما لكل نوع رسالة أو لجميع أنواع الرسائل إذا كنت تستخدم القيم الافتراضية.

    تظهر لقطة الشاشة إعدادات اتفاقية X12 لتعطيل التحقق من الصحة لجميع أنواع الرسائل أو كل نوع رسالة.

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

تبادل رسائل X12