مشاركة عبر

تبادل رسائل X12 باستخدام مهام سير العمل في Azure Logic Apps

  • مقالة

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

لإرسال واستقبال رسائل X12 في مهام سير العمل التي تقوم بإنشائها باستخدام Azure Logic Apps، استخدم موصل X12 ، الذي يوفر العمليات التي تدعم اتصال X12 وتديره.

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

مرجع تقني الاتصال أو

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

المتطلبات الأساسية

  • حساب واشتراك Azure. إذا لم يكن لديك اشتراك Azure حتى الآن، فسجِّل للحصول على حساب Azure مجاني.

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

    • يجب أن يكون كل من حساب التكامل ومورد تطبيق المنطق موجودين في نفس اشتراك Azure ومنطقة Azure.

    • يحدد اثنين على الأقل من الشركاء التجاريين المشاركين في عملية X12 المستخدمة في سير العمل الخاص بك. يجب أن تستخدم التعريفات لكلا الشريكين نفس مؤهل هوية العمل X12.

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

      هام

      إذا كنت تعمل مع مخططات قانون نقل التأمين الصحي والمساءلة (HIPAA)، فيجب عليك إضافة قسم schemaReferences إلى الاتفاقية. لمزيد من المعلومات، راجع مخططات HIPAA وأنواع الرسائل.

    • تعريف المخططات لاستخدامها للتحقق من صحة XML.

      هام

      إذا كنت تعمل مع مخططات قانون نقل التأمين الصحي والمساءلة (HIPAA)، فتأكد من مراجعة مخططات HIPAA وأنواع الرسائل.

  • استنادا إلى ما إذا كنت تعمل على سير عمل Consumption أو Standard logic app، قد يتطلب مورد تطبيق المنطق ارتباطا بحساب التكامل الخاص بك:

    سير عمل تطبيق المنطق هل الارتباط مطلوب؟
    الاستهلاك‬ مطلوب الاتصال والارتباط بحساب التكامل. يمكنك إنشاء الاتصال عند إضافة عملية X12 إلى سير العمل.
    قياسي الاتصال إلى حساب التكامل مطلوب، ولكن لا يوجد ارتباط مطلوب. يمكنك إنشاء الاتصال عند إضافة عملية X12 إلى سير العمل.

  • مورد تطبيق المنطق وسير العمل حيث تريد استخدام عمليات X12.

    لمزيد من المعلومات، راجع الوثائق التالية:

شفر رسائل X12

تنفذ عملية رسالة الترميز إلى X12 المهام التالية:

  • يحل الاتفاقية عن طريق مطابقة خصائص سياق المرسل والمتلقي.
  • تسلسل تبادل EDI وتحويل الرسائل المشفرة XML إلى مجموعات معاملات EDI في التبادل.
  • تطبيق أجزاء رأس ومقطورة لمجموعة المعاملات.
  • إنشاء رقم عنصر تحكم تبادل ورقم عنصر تحكم مجموعة ورقم عنصر تحكم مجموعة معاملات لكل تبادل صادر.
  • يستبدل الفواصل في بيانات الحمولة.
  • التحقق من صحة EDI والخصائص الخاصة بالشريك.
    • التحقق من صحة المخطط لعناصر بيانات مجموعة المعاملات مقابل مخطط الرسالة.
    • التحقق من صحة EDI على عناصر بيانات مجموعة المعاملات.
    • التحقق الموسع من صحة عناصر بيانات مجموعة المعاملات.
  • يطلب إعلاما فنيا ووظيفيا، إذا تم تكوينه.
    • ينشئ إقرارا تقنيا كنتيجة للتحقق من صحة العنوان. يُبلغ الإقرار التقني عن حالة معالجة عنوان ومعلومات ملحقة تبادلية عن طريق مُستقبل العنوان.
    • إنشاء إقرار وظيفي كنتيجة للتحقق من صحة الجسم. يبلغ الإقرار الوظيفي عن كل خطأ تمت مواجهته أثناء معالجة المستند المستلم.

  1. في مدخل Microsoft Azure، افتح مورد وسير عمل التطبيق المنطقي في المُصمم.

  2. في المصمم، اتبع هذه الخطوات العامة لإضافة إجراء X12 المسمى ترميز إلى رسالة X12 عن طريق اسم الاتفاقية إلى سير العمل الخاص بك.

    إشعار

    إذا كنت تريد استخدام إجراء ترميز إلى رسالة X12 حسب الهويات بدلا من ذلك، يجب عليك لاحقا توفير قيم مختلفة، مثل معرف المرسل ومعرف المتلقي المحدد في اتفاقية X12. يجب عليك أيضًا تحديد رسالة XML لتشفير، والتي يمكن أن تكون الإخراج من المشغل أو إجراء سابق.

  3. عند المطالبة، قم بتوفير معلومات الاتصال التالية لحساب التكامل الخاص بك:

    الخاصية المطلوب ‏‏الوصف
    اسم الاتصال ‏‏نعم‬ اسم للاتصال
    حساب التكامل ‏‏نعم‬ من قائمة حسابات التكامل المتوفرة، حدد الحساب الذي تريد استخدامه.

    على سبيل المثال:

    Screenshot showing Consumption workflow and connection information for action named Encode to X12 message by agreement name.

  4. عند الانتهاء، حدد إنشاء.

  5. في مربع معلومات الإجراء X12، قم بتوفير قيم الخصائص التالية:

    الخاصية المطلوب ‏‏الوصف
    اسم اتفاقية X12 ‏‏نعم‬ اتفاقية X12 لاستخدامها.
    رسالة XML المراد ترميزها ‏‏نعم‬ رسالة XML المراد ترميزها
    معلمات أخرى لا تتضمن هذه العملية المعلمات الأخرى التالية:

    - فاصل عناصر البيانات
    - فاصل المكونات
    - حرف الاستبدال
    - فاصل مقطعي
    - لاحقة فاصل مقطعي
    - Control Version Number
    - معرف مرسل التطبيق/رمز GS02
    - معرف متلقي التطبيق/رمز GS03

    لمزيد من المعلومات، راجع إعدادات رسالة X12.

    على سبيل المثال، يمكنك استخدام إخراج محتوى النص الأساسي من مشغل الطلب كحمولة رسالة XML:

    Screenshot showing Consumption workflow, action named Encode to X12 message by agreement name, and action properties.

رسائل Decode X12

تقوم عملية رسالة فك ترميز X12 بتنفيذ المهام التالية:

  • التحقق من صحة المغلف مقابل اتفاقية شريك التداول.

  • التحقق من صحة EDI والخصائص الخاصة بالشريك.

    • التحقق الهيكلي من EDI والتحقق من صحة المخطط الموسع
    • التحقق من صحة هيكل المغلف التبادلي
    • التحقق من صحة المخطط للمغلف مقابل مخطط عنصر التحكم
    • التحقق من صحة المخطط لعناصر بيانات مجموعة المعاملات مقابل مخطط الرسالة
    • التحقق من صحة EDI على عناصر بيانات مجموعة المعاملات

  • يتحقق من أن أرقام التحكم في مجموعة المعاملات والمجموعة والتبادل ليست مكررة.

    • يتحقق من رقم عنصر التحكم تبادل مقابل التبادلات المستلمة مسبقًا.
    • يتحقق من رقم عنصر تحكم المجموعة مقابل أرقام عناصر تحكم المجموعة الأخرى في التبادل.
    • يتحقق من رقم عنصر تحكم مجموعة المعاملات مقابل أرقام عناصر تحكم مجموعة المعاملات الأخرى في تلك المجموعة.

  • تقسيم تبادل إلى مجموعات معاملات، أو الحفاظ على التبادل بأكمله:

    • تقسيم التبادل إلى مجموعات معاملات أو تعليق مجموعات المعاملات عند الخطأ: تحليل كل مجموعة معاملات. إخراج إجراء فك تشفير X12 فقط مجموعات المعاملات التي تفشل في التحقق من الصحة إلى badMessages، وإخراج مجموعات المعاملات المتبقية إلى goodMessages.

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

    • الاحتفاظ بتبادل أو تعليق مجموعات المعاملات عند الخطأ: الاحتفاظ بالتبادل ومعالجة التبادل المجمع بالكامل. إخراج إجراء فك تشفير X12 فقط مجموعات المعاملات التي تفشل في التحقق من الصحة إلى badMessages، وإخراج مجموعات المعاملات المتبقية إلى goodMessages.

    • الاحتفاظ بالتبادل أو تعليق التبادل عند الخطأ: الاحتفاظ بالتبادل ومعالجة التبادل المجمع بالكامل. إذا كانت مجموعة معاملة واحدة أو أكثر في التحقق من فشل تبادل البيانات، فإن إجراء فك ترميز X12 إخراج كافة مجموعات المعاملات في هذا التبادل إلى badMessages.

  • إنشاء إعلام فني ووظيفي، إذا تم تكوينه.

    • ينشئ إقرارا تقنيا كنتيجة للتحقق من صحة العنوان. يُبلغ الإقرار التقني عن حالة معالجة عنوان ومعلومات ملحقة تبادلية عن طريق مُستقبل العنوان.
    • إنشاء إقرار وظيفي كنتيجة للتحقق من صحة الجسم. يبلغ الإقرار الوظيفي عن كل خطأ تمت مواجهته أثناء معالجة المستند المستلم.

  1. في مدخل Microsoft Azure، افتح مورد وسير عمل التطبيق المنطقي في المُصمم.

  2. في المصمم، اتبع هذه الخطوات العامة لإضافة إجراء X12 المسمى رسالة Decode X12 إلى سير العمل.

  3. عند المطالبة، قم بتوفير معلومات الاتصال التالية لحساب التكامل الخاص بك:

    الخاصية المطلوب ‏‏الوصف
    اسم الاتصال ‏‏نعم‬ اسم للاتصال
    حساب التكامل ‏‏نعم‬ من قائمة حسابات التكامل المتوفرة، حدد الحساب الذي تريد استخدامه.

    على سبيل المثال:

    Screenshot showing Consumption workflow and connection information for action named Decode X12 message.

  4. عند الانتهاء، حدد إنشاء.

  5. في مربع معلومات الإجراء X12، قم بتوفير قيم الخصائص التالية:

    الخاصية المطلوب ‏‏الوصف
    رسالة ملف X12 مسطحة لفك ترميزها ‏‏نعم‬ رسالة X12 بتنسيق ملف ثابت لفك ترميزها

    ملاحظة: حمولة رسالة XML أو محتوى صفيف الرسالة، جيد أو سيئ، مشفر ب base64. لذلك، يجب استخدام تعبير يعالج هذا المحتوى. على سبيل المثال، يعالج التعبير التالي محتوى الرسالة ك XML:

    xml(base64ToBinary(item()?['Body']))
    معلمات أخرى لا تتضمن هذه العملية المعلمات الأخرى التالية:

    - Preserve Interchange
    - تعليق تبادل عند الخطأ

    لمزيد من المعلومات، راجع إعدادات رسالة X12.

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

    Screenshot showing Consumption workflow, action named Decode X12 message, and action properties.

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