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

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

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

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

يحتوي موصل EDIFACT على إصدارات مختلفة، استنادا إلى نوع التطبيق المنطقي وبيئة المضيف.

تطبيق المنطق البيئة إصدار الاتصال or
الاستهلاك تطبيقات Azure Logic Apps متعددة المستأجرين موصل EDIFACT المدار (فئة قياسية). يوفر موصل EDIFACT إجراءات فقط، ولكن يمكنك استخدام أي مشغل يعمل مع السيناريو الخاص بك. لمزيد من المعلومات، راجع الوثائق التالية:

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

- مرجع موصل EDIFACT المدار
- حدود رسائل EDIFACT
قياسي تطبيقات Azure Logic للمستأجر الفردي وبيئة خدمة التطبيقات الإصدار 3 (خطط Windows فقط) موصل EDIFACT المضمن (معاينة) وموصل EDIFACT المدار. يختلف الإصدار المضمن بالطرق التالية:

- يوفر الإصدار المضمن إجراءات فقط، ولكن يمكنك استخدام أي مشغل يعمل مع السيناريو الخاص بك.

- يمكن للإصدار المضمن الوصول مباشرة إلى شبكات Azure الظاهرية. لا تحتاج إلى بوابة بيانات محلية.

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

- مرجع موصل EDIFACT المدار
- عمليات الموصل المضمنة في EDIFACT
- حدود رسائل EDIFACT

عمليات EDIFACT المضمنة (مهام سير العمل القياسية فقط - معاينة)

يحتوي موصل EDIFACT المضمن للمعاينة على الإجراءات التالية، والتي تشبه إجراءات الموصل المدارة ل EDIFACT النظيرة، باستثناء الحالات المذكورة في القيود والمشكلات المعروفة.

القيود والمشاكل المعروفة

  • معاينة موصل EDIFACT المضمن

    • هذه الإمكانية قيد المعاينة وتخضع لشروط الاستخدام التكميلية لمعاينات Microsoft Azure.

    • تدعم إجراءات هذا الموصل حاليا حمولات تصل إلى 100 ميغابايت على الأقل.

    • لا يتضمن إجراء فك ترميز EDIFACT الأولي حاليا الإمكانات التالية:

      • تحقق من وجود أرقام عناصر تحكم مجموعة وحركات وتبادل مكررة، إذا تم تكوينها.

      • الاحتفاظ بالتبادل بأكمله.

      وإلا، فإن معاينة EDIFACT Encode وإجراءات موصل EDIFACT المضمنة لديها قدرات مشابهة لإجراءات الموصل المدارة ل EDIFACT النظيرة.

    • لا تدعم إجراءات هذا الموصل حاليا التبادلات مع معاملات متعددة أو رسائل مجمعة.

    • لا تصدر إجراءات هذا الموصل حاليا تتبعا خاصا ب EDI.

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

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

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

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

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

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

      هام

      يدعم موصل EDIFACT أحرف UTF-8 فقط. إذا احتوى الإخراج على أحرف غير متوقعة، فتحقق من أن رسائل EDIFACT تستخدم مجموعة أحرف UTF-8.

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

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

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

تشفير رسائل EDIFACT

يقوم إجراء الموصل المدار EDIFACT المسمى Encode إلى إجراء رسالة EDIFACT وإجراء الموصل المضمن EDIFACT المسمى EDIFACT Encode بتنفيذ المهام التالية، باستثناء الحالات المذكورة في القيود والمشكلات المعروفة:

  • قم بحل الاتفاقية عن طريق مطابقة مؤهل المرسل ومعرفه ومعرف جهاز الاستقبال ومعرفه.

  • تسلسل التبادل الإلكتروني للبيانات (EDI)، الذي يحول الرسائل المشفرة XML إلى مجموعات معاملات التبادل الإلكتروني للبيانات في التبادل.

  • تطبيق عنوان مجموعة المعاملات وقطاعات المعلومات الملحقة.

  • توليد رقم تحكم في التبادل، رقم تحكم في مجموعة، ورقم تحكم في مجموعة معاملة لكل تبادل صادر.

  • استبدال الفواصل الموجودة في بيانات الحمولة.

  • التحقق من صحة EDI والخواص الخاصة بالشركاء، مثل مخطط عناصر بيانات مجموعة المعاملات مقابل مخطط الرسالة، عناصر بيانات مجموعة المعاملات، والتحقق الموسع من صحة عناصر بيانات مجموعة المعاملات.

  • إنشاء مستند XML لكل مجموعة معاملات.

  • اطلب إقرارًا فنيًا أو إقرارًا وظيفيًا أو كليهما، إذا تم تكوينها.

    • كإقرار فني، تشير رسالة CONTRL إلى إيصال التبادل.

    • كإقرار وظيفي، تشير رسالة CONTRL إلى قبول أو رفض التبادل أو المجموعة أو الرسالة المستلمة، بما في ذلك قائمة الأخطاء أو الوظائف غير المدعومة.

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

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

    إشعار

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

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

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

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

    Screenshot shows Azure portal, Consumption workflow, and connection box for action named Encode to EDIFACT message by agreement name.

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

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

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

    - فاصل عناصر البيانات
    - مؤشر الإصدار
    - فاصل المكونات
    - فاصل التكرار
    - فاصل مقطعي
    - لاحقة فاصل مقطعي
    - مؤشر عشري

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

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

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

  6. احفظ سير العمل الخاص بك.

تبادل رسائل EDIFACT

ينفذ إجراء الموصل المدار EDIFACT المسمى إجراء رسالة Decode EDIFACT وإجراء الموصل المضمن EDIFACT المسمى EDIFACT Decode المهام التالية، باستثناء الحالات المذكورة في القيود والمشكلات المعروفة:

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

  • قم بحل الاتفاقية من خلال مطابقة مؤهل المرسل والمعرف جنبًا إلى جنب مع مؤهل ومعرف المستلم.

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

  • فك التقاطع.

  • تحقق من صحة تبادل البيانات الإلكترونية (EDI) والخصائص الخاصة بالشريك، مثل بنية مغلف تبادلي، ومخطط المغلف مقابل مخطط التحكم، ومخطط عناصر بيانات مجموعة المعاملات مقابل مخطط الرسالة، والتحقق الموسع من صحة عناصر بيانات مجموعة المعاملات.

  • تحقق من أن أرقام التحكم في التبادل والمجموعة ومجموعة المعاملات ليست مكررة (موصل مدار فقط)، إذا تم تكوينها، على سبيل المثال:

    • تحقق من رقم عنصر التحكم تبادل مقابل تداخلات تم تلقيها مسبقا.

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

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

  • تقسيم التبادل إلى مجموعات معاملات، أو الاحتفاظ بالتبادل بأكمله (الموصل المدار فقط)، على سبيل المثال:

    • تقسيم التبادل كمجموعات معاملات - تعليق مجموعات المعاملات عند الخطأ.

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

    • تقسيم التبادل كمجموعات معاملات - تعليق تبادل عند الخطأ.

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

    • الاحتفاظ بـ Interchange - تعليق مجموعات المعاملات عند الخطأ.

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

    • الاحتفاظ بالتداخل - تعليق تبادل عند الخطأ.

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

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

    • إقرار فني أو CONTRL ACK، الذي يبلغ عن النتائج من التحقق النحوي على التبادل المستلم الكامل.

    • إقرار وظيفي يعترف بقبول أو رفض التبادل أو المجموعة المستلمة.

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

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

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

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

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

    Screenshot shows Consumption workflow designer and connection pane for the action named Decode EDIFACT message.

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

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

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

    - فاصل المكونات
    - فاصل عناصر البيانات
    - مؤشر الإصدار
    - فاصل التكرار
    - فاصل مقطعي
    - لاحقة فاصل مقطعي
    - مؤشر عشري
    - مجموعة أحرف الحمولة
    - لاحقة فاصل مقطعي
    - Preserve Interchange
    - تعليق تبادل عند الخطأ

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

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

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

معالجة مقاطع UNH2.5 في مستندات EDIFACT

في مستند EDIFACT، يتم استخدام مقطع UNH2.5 للبحث عن المخطط. على سبيل المثال، في رسالة EDIFACT النموذجية هذه، يكون حقل UNH هو EAN008:

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

لمعالجة مستند EDIFACT أو معالجة رسالة EDIFACT تحتوي على مقطع UN2.5، اتبع الخطوات التالية:

  1. تحديث أو نشر مخطط يحتوي على اسم العقدة الجذرية UNH2.5.

    على سبيل المثال، افترض أن اسم جذر المخطط لحقل UNH النموذجي هو EFACT_D03B_ORDERS_EAN008. D03B_ORDERS لكل مقطع له جزء UNH2.5 مختلف، يجب عليك نشر مخطط فردي.

  2. في مدخل Microsoft Azure، أضف المخطط إلى مورد حساب التكامل أو مورد تطبيق المنطق، استنادا إلى ما إذا كان لديك سير عمل Consumption أو Standard logic app على التوالي.

  3. سواء كنت تستخدم إجراء فك ترميز EDIFACT أو ترميزه، قم بتحميل المخطط وإعداد إعدادات المخطط في قسمي تلقي الإعدادات أو إرسال الإعدادات في اتفاقية EDIFACT على التوالي.

  4. لتحرير اتفاقية EDIFACT، في جزء الاتفاقيات، حدد الاتفاقية خاصتك. في شريط أدوات جزء الاتفاقيات، حدد تحرير ك JSON.

    • في قسم الاتفاقية receiveAgreement، ابحث عن schemaReferences القسم، وأضف قيمة UNH2.5.

      Screenshot showing the Azure portal with an EDIFACT agreement's

    • في قسم الاتفاقية sendAgreement، ابحث عن schemaReferences القسم، وأضف قيمة UNH2.5.

      Screenshot showing the Azure portal with an EDIFACT agreement's

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