Exchange رسائل EDIFACT باستخدام مهام سير العمل في تطبيقات Azure المنطقية

  • مقالة
  • قراءة خلال 10 دقائق

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

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

Overview screenshot showing the

تشفير وفك تشفير EDIFACT

تصف الأقسام التالية المهام التي يمكنك إكمالها باستخدام إجراءات ترميز EDIFACT وفك تشفيرها.

الترميز إلى إجراء رسالة EDIFACT

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

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

  • تطبيق شرائح رأس مجموعة المعاملات والمقطع الدعائي.

  • قم بإنشاء رقم تحكم تبادل ورقم تحكم مجموعة ورقم تحكم مجموعة معاملات لكل تبادل صادر.

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

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

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

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

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

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

فك تشفير إجراء رسالة EDIFACT

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

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

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

  • تفكيك التبادل.

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

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

    • تحقق من رقم عنصر تحكم التبادل مقابل التقاطعات المستلمة مسبقا.

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

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

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

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

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

    • تقسيم التبادل كما يحدد المعاملات - تعليق التبادل على خطأ.

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

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

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

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

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

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

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

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

مرجع الموصل

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

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

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

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

    • مقترن بنفس اشتراك Azure مثل مورد التطبيق المنطقي.

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

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

    • عند استخدام نوع مورد تطبيق المنطق (قياسي) وعمليات EDIFACT، يتطلب سير العمل اتصالا بحساب التكامل الذي تقوم بإنشائه مباشرة من سير العمل عند إضافة عملية AS2.

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

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

    هام

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

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

    إذا كنت جديدا على التطبيقات المنطقية، فراجع ما هي تطبيقات Azure Logicوالتشغيل السريع: أنشئ تطبيقك المنطقي الأول.

ترميز رسائل EDIFACT

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

  2. على المصمم، ضمن المشغل أو الإجراء الذي تريد إضافة إجراء EDIFACT، حدد خطوة جديدة.

  3. ضمن مربع البحث Choose an operation، حدد All. في مربع البحث، أدخل edifact encode. على سبيل المثال، حدد الإجراء المسمى ترميز إلى رسالة EDIFACT حسب اسم الاتفاقية.

    Screenshot showing the Azure portal, workflow designer, and

    ملاحظة

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

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

    الخاصية مطلوب الوصف
    ⁧⁩اسم الاتصال⁧⁩ نعم اسم للاتصال
    حساب التكامل نعم من قائمة حسابات التكامل المتاحة، حدد الحساب المطلوب استخدامه.

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

    Screenshot showing the

  5. عند الانتهاء، حدد "Create" .

  6. بعد ظهور عملية EDIFACT على المصمم، قم بتوفير معلومات للخصائص التالية الخاصة بهذه العملية:

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

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

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

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

    Screenshot showing the

فك تشفير رسائل EDIFACT

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

  2. على المصمم، ضمن المشغل أو الإجراء الذي تريد إضافة إجراء EDIFACT، حدد خطوة جديدة.

  3. ضمن مربع البحث Choose an operation، حدد All. في مربع البحث، أدخل edifact encode. حدد الإجراء المسمى فك تشفير رسالة EDIFACT.

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

    الخاصية مطلوب الوصف
    ⁧⁩اسم الاتصال⁧⁩ نعم اسم للاتصال
    حساب التكامل نعم من قائمة حسابات التكامل المتاحة، حدد الحساب المطلوب استخدامه.

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

    Screenshot showing the

  5. عند الانتهاء، حدد "Create" .

  6. بعد ظهور عملية EDIFACT على المصمم، قم بتوفير معلومات للخصائص التالية الخاصة بهذه العملية:

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

    - فاصل المكونات
    - فاصل عنصر البيانات
    - مؤشر الافراج
    - فاصل التكرار
    - منهية الشرائح
    - لاحقة نهاية المقطع
    - مؤشر عشري
    - مجموعة أحرف الحمولة الصافية
    - لاحقة نهاية المقطع
    - الحفاظ على التبادل
    - تعليق التبادل عند الخطأ

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

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

    Screenshot showing the

التعامل مع قطاعات 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. في مدخل Azure، أضف المخطط إلى مورد حساب التكامل أو مورد التطبيق المنطقي، والذي يستند إلى ما إذا كنت تعمل مع نوع مورد تطبيق المنطق (الاستهلاك ) أو التطبيق المنطقي (قياسي) على التوالي.

  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

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