تبادل رسائل RosettaNet لتكامل B2B باستخدام مهام سير العمل في Azure Logic Apps
التطبيق على:Azure Logic Apps (Consumption)
لإرسال رسائل RosettaNet وتلقيها في مهام سير العمل التي تقوم بإنشائها باستخدام Azure Logic Apps، يمكنك استخدام موصل RosettaNet، الذي يوفر إجراءات تدير وتدعم الاتصال الذي يتبع معايير RosettaNet. RosettaNet عبارة عن اتحاد غير ربحي أنشأ عمليات قياسية لمشاركة معلومات الأعمال. تُستخدم هذه المعايير بشكل شائع لعمليات سلسلة التوريد وهي منتشرة في صناعات أشباه الموصلات والإلكترونيات واللوجستيات. يقوم اتحاد RosettaNet بإنشاء وصيانة Partner Interface Processes (PIPs)، والتي توفر تعريفات عمليات الأعمال المشتركة لجميع عمليات تبادل رسائل RosettaNet. تعتمد RosettaNet على XML وتحدد إرشادات الرسائل وواجهات العمليات التجارية وأطر التنفيذ للتواصل بين الشركات. لمزيد من المعلومات، تفضل بزيارة موقع RosettaNet.
يستند الموصل إلى الإصدار 2.0.01 من RosettaNet Implementation Framework (RNIF) ويدعم جميع PIPs المحددة بواسطة هذا الإصدار. RNIF هو إطار عمل تطبيق شبكة مفتوح يمكّن شركاء الأعمال من تشغيل RosettaNet PIPs بشكل تعاوني. يحدد إطار العمل هذا بنية الرسالة، والحاجة إلى إقرارات، وتشفير ملحقات بريد الإنترنت متعدد الأغراض (MIME)، ترميز والتوقيع الرقمي. يمكن أن يكون التواصل مع الشريك متزامناً أو غير متزامن. يوفر الموصل الإمكانات التالية:
- تلقي رسائل RosettaNet أو فك ترميزها.
- إرسال رسائل RosettaNet أو ترميزها.
- انتظر الرد وإنشاء إعلام بالفشل.
يوضح دليل الكيفية هذا كيفية إرسال رسائل RosettaNet وتلقيها في مهام سير العمل باستخدام Azure Logic Apps وموصل RosettaNet من خلال إكمال المهام التالية:
- أضف تكوين عملية PIP، إذا لم يكن لديك تكوين بالفعل.
- إنشاء اتفاقية RosettaNet.
- إضافة إجراء يتلقى رسائل RosettaNet أو يفك ترميزها.
- أضف إجراء يرسل رسائل RosettaNet أو يقوم بترميزها.
مفاهيم RosettaNet
المفاهيم والمصطلحات التالية فريدة من نوعها لمواصفات RosettaNet ومن المهم معرفة متى تقوم بإنشاء مهام سير عمل التكامل المستندة إلى RosettaNet:
PIP
تقوم مؤسسة RosettaNet بإنشاء وصيانة PIPs، والتي توفر تعريفات عملية تجارية مشتركة لجميع عمليات تبادل رسائل RosettaNet. توفر كل مواصفة PIP ملف تعريف نوع الوثيقة (DTD) ووثيقة توجيهية للرسالة. يحدد ملف DTD بنية رسالة محتوى الخدمة. يحدد مستند إرشادات الرسالة، وهو ملف HTML قابل للقراءة من قبل الإنسان، القيود على مستوى العنصر. توفر هذه الملفات معاً تعريفاً كاملاً لعملية الأعمال.
يتم تصنيف PIPs بواسطة وظيفة عمل عالية المستوى، أو مجموعة، ووظيفة فرعية، أو مقطع. على سبيل المثال، "3A4" هو PIP لأمر الشراء، بينما "3" هي دالة إدارة الطلبات، و"3A" هي الوظيفة الفرعية لإدخال طلب الاقتباس. لمزيد من المعلومات، تفضل بزيارة موقع RosettaNet.
الإجراء
جزء من PIP، رسائل العمل عبارة عن رسائل أعمال يتم تبادلها بين الشركاء.
إشارة
جزء من PIP، رسائل الإشارة هي إقرارات يتم إرسالها استجابة لرسائل العمل.
إجراء فردي وعمل مزدوج
بالنسبة إلى PIP أحادي الإجراء، تكون الاستجابة الوحيدة هي رسالة إشارة إقرار. بالنسبة إلى PIP ذات الإجراء المزدوج، يتلقى البادئ رسالة استجابة ويرد مع إقرار بالإضافة إلى تدفق الرسالة أحادية الإجراء.
مرجع تقني للموصل
يتوفر موصل RosettaNet فقط لسير عمل تطبيق منطق الاستهلاك.
| تطبيق المنطق | البيئة | إصدار الموصل |
|---|---|---|
| استهلاك | تطبيقات Azure Logic Apps متعددة المستأجرين | الموصل المدار، الذي يظهر في المصمم أسفل التسمية القياسية . يوفر موصل RosettaNet إجراءات فقط، ولكن يمكنك استخدام أي مشغل يعمل مع السيناريو الخاص بك. لمزيد من المعلومات، راجع الوثائق التالية: - عمليات موصل RosettaNet - حدود بروتوكول B2B لأحجام الرسائل - الموصلات المُدارة Azure Logic Apps |
عمليات RosettaNet
لا يحتوي موصل RosettaNet على مشغلات. يصف الجدول التالي الإجراءات التي يوفرها موصل RosettaNet لإنشاء الأمان والموثوقية عند إرسال الرسائل:
| الإجراء | الوصف |
|---|---|
| إجراء ترميز RosettaNet | إرسال رسائل RosettaNet باستخدام الترميز الذي يتبع معايير RosettaNet. |
| إجراء فك ترميز RosettaNet | تلقي رسائل RosettaNet باستخدام فك التشفير الذي يتبع معايير RosettaNet. |
| RosettaNet تنتظر إجراء الاستجابة | انتظر المضيف للحصول على استجابة RosettaNet أو رسالة إشارة من المتلقي. |
المتطلبات الأساسية
حساب واشتراك Azure. إذا لم يكن لديك اشتراك، فبادر بإنشاء حساب مجاني.
مورد تطبيق منطق الاستهلاك وسير العمل حيث تريد استخدام عمليات RosettaNet.
حساب تكامل لتخزين الاتفاقية الخاصة بك وغيرها من البيانات الاصطناعية من شركة إلى عمل (B2B).
هام
يجب أن يتواجد كل من حساب التكامل ومورد تطبيق المنطق في نفس اشتراك Azure ومنطقة Azure ليعملا معاً. لاستخدام البيانات الاصطناعية لحساب التكامل في سير العمل الخاص بك، تأكد من ربط مورد تطبيق المنطق بحساب التكامل الخاص بك.
شريكان على الأقل معرفان في حساب التكامل الخاص بك ويستخدمان مؤهل DUNS ضمن الهويات التجارية في مدخل Microsoft Azure.
إشعار
تأكد من تحديد DUNS كمتأهل، والذي يمكنك العثور عليه بالقرب من أسفل قائمة التصفيات ، وليس 1 - D-U-N-S (Dun &Bradstreet).
شهادات اختيارية لتشفير أو فك تشفير أو توقيع الرسائل التي تقوم بتحميلها إلى حساب التكامل. الشهادات مطلوبة فقط إذا كنت تستخدم التوقيع أو التشفير.
إضافة تكوين عملية PIP
لإرسال رسائل RosettaNet أو تلقيها، يتطلب حساب التكامل تكوين عملية PIP، إذا لم يكن لديك واحدة بالفعل. يخزن تكوين العملية جميع خصائص تكوين PIP. يمكنك بعد ذلك الرجوع إلى هذا التكوين عند إنشاء اتفاقية مع شريك.
في قائمة التنقل في حساب التكامل، ضمن Settings، حدد RosettaNet PIP.
في صفحة RosettaNet PIP ، حدد Add. في جزء إضافة عملية واجهة الشريك، أدخل تفاصيل PIP الخاصة بك.
الخاصية المطلوب الوصف الاسم نعم اسم PIP الخاص بك. تعليمة PIP البرمجية نعم رمز PIP المكون من ثلاثة أرقام. لمزيد من المعلومات، راجع RosettaNet PIPs. إصدار PIP نعم رقم إصدار PIP، والذي يعتمد على رمز PIP المحدد. لمزيد من المعلومات بشأن خصائص PIP هذه، قم بزيارة موقع RosettaNet على الويب.
عند الانتهاء، حدد OK لإنشاء تكوين PIP.
لعرض تكوين العملية أو تحريره، حدد PIP، وحدد Edit as JSON.
تأتي جميع إعدادات تكوين العملية من مواصفات PIP. تملأ Azure Logic Apps معظم الإعدادات بالقيم الافتراضية التي هي القيم الأكثر استخداما لهذه الخصائص.
تأكد من أن الإعدادات تتوافق مع القيم الموجودة في مواصفات PIP المناسبة وتفي باحتياجات عملك. إذا لزم الأمر، فحدِّث القيم في JSON واحفظ هذه التغييرات.
قم بإنشاء اتفاقية RosettaNet
في قائمة التنقل في حساب التكامل، ضمن Settings، حدد Agreements.
في صفحة Agreements ، حدد Add. ضمن إضافة، أدخل تفاصيل الاتفاقية.
الخاصية المطلوب الوصف الاسم نعم اسم الاتفاقية. نوع الاتفاقية نعم نوع الاتفاقية. حدد RosettaNet. شريك مضيف نعم المؤسسة التي تقوم بتكوين الاتفاقية. تتطلب الاتفاقية كلاً من المضيف والشريك الضيف. هوية المضيف نعم معرف لشريك المضيف. شريك ضيف نعم المؤسسة التي تتعامل مع الشريك المضيف. تتطلب الاتفاقية كلاً من المضيف والشريك الضيف. هوية الضيف نعم معرف لشريك الضيف. تلقي الإعدادات يتفاوت الخصائص التي تنطبق على جميع الرسائل التي يتلقاها الشريك المضيف. Send Settings يتفاوت الخصائص التي تنطبق على جميع الرسائل المرسلة من قبل الشريك المضيف. مراجع RosettaNet PIP نعم مراجع PIP للاتفاقية. تتطلب جميع رسائل RosettaNet تكوينات PIP. لإعداد اتفاقيتك لتلقي الرسائل الواردة من الشريك الضيف، حدد Receive Settings.
لتمكين التوقيع أو التشفير للرسائل الواردة، ضمن رسالة، حدد يجب توقيع الرسالة أو يجب تشفير الرسالة، على التوالي.
الخاصية المطلوب الوصف يجب توقيع الرسالة لا خيار تسجيل الرسائل الواردة باستخدام الشهادة المحددة شهادة نعم، إذا تم تمكين التوقيع الشهادة التي سيتم استخدامها للتوقيع تمكين تشفير الرسائل لا خيار تشفير الرسائل الواردة باستخدام الشهادة المحددة شهادة نعم، إذا تم تمكين التشفير الشهادة المراد استخدامها للتشفير ضمن كل تحديد، حدد الشهادة في حساب التكامل الذي تريد استخدامه للتوزيع أو التشفير.
لإعداد اتفاقيتك لإرسال رسائل إلى الشريك الضيف، حدد Send Settings.
لتمكين التوقيع أو التشفير للرسائل الصادرة، ضمن الرسائل، حدد تمكين توقيع الرسالة أو تمكين تشفير الرسائل، على التوالي. ضمن كل تحديد، حدد الخوارزمية والشهادة في حساب التكامل الذي تريد استخدامه للتوزيع أو التشفير.
الخاصية المطلوب الوصف تمكين توقيع الرسائل لا خيار تسجيل الرسائل الصادرة باستخدام خوارزمية التوقيع المحددة والشهادة خوارزمية التوقيع نعم، إذا تم تمكين التوقيع خوارزمية التوقيع المراد استخدامها، بناءً على الشهادة المحددة شهادة نعم، إذا تم تمكين التوقيع الشهادة التي سيتم استخدامها للتوقيع تمكين تشفير الرسائل لا خيار تشفير الرسائل الصادرة باستخدام خوارزمية التشفير المحددة والشهادة خوارزمية التشفير نعم، إذا تم تمكين التشفير خوارزمية التشفير المراد استخدامها، بناءً على الشهادة المحددة شهادة نعم، إذا تم تمكين التشفير الشهادة المراد استخدامها للتشفير ضمن Endpoints، حدد عناوين URL المطلوبة لاستخدامها في إرسال رسائل وإقرارات الإجراءات.
الخاصية المطلوب الوصف عنوان URL للإجراء نعم عنوان URL المراد استخدامه لإرسال رسائل العمل. عنوان URL هو حقل مطلوب لكل من الرسائل المتزامنة وغير المتزامنة. عنوان URL للإقرار نعم عنوان URL المراد استخدامه لإرسال رسائل إقرار بالاستلام. عنوان URL هو حقل مطلوب للرسائل غير المتزامنة.
لإعداد اتفاقيتك مع مراجع RosettaNet PIP للشركاء، حدد RosettaNet PIP references. ضمن اسم PIP، حدد اسم PIP الذي قمت بإنشائه سابقا.
يقوم اختيارك بملء الخصائص المتبقية، والتي تستند إلى PIP التي قمت بإعدادها في حساب التكامل الخاص بك. إذا لزم الأمر، يمكنك تغيير دور PIP.
بعد إكمال هذه الخطوات، تكون جاهزاً لإرسال رسائل RosettaNet أو تلقيها.
تلقي أو فك تشفير رسائل RosettaNet
في مدخل Microsoft Azure، افتح سير عمل تطبيق Consumption المنطقي في المصمم.
يجب أن يحتوي سير العمل الخاص بك بالفعل على مشغل وأي إجراءات أخرى تريد تشغيلها قبل إضافة إجراء RosettaNet. يستمر هذا المثال مع مشغل الطلب.
ضمن المشغل أو الإجراء، حدد خطوة جديدة.
ضمن مربع البحث Choose an operation، حدد All. في مربع البحث، أدخل rosettanet. من قائمة الإجراءات، حدد الإجراء المسمى RosettaNet Decode.
أدخل المعلومات الخاصة بخصائص الإجراء:
الخاصية المطلوب الوصف رسالة نعم رسالة RosettaNet المطلوب فك تشفيرها رؤوس نعم رؤوس HTTP التي توفر القيم للإصدار، وهو إصدار RNIF، ونوع الاستجابة، والتي تشير إلى نوع الاتصال بين الشركاء ويمكن أن تكون متزامنة أو غير متزامنة الدور نعم دور الشريك المضيف في PIP يتضمن إخراج إجراء فك ترميز RosettaNet إشارة صادرة. يمكنك ترميز هذا الإخراج وإعادته إلى الشريك، أو يمكنك اتخاذ أي إجراء آخر على هذا الإخراج.
إرسال أو تشفير رسائل RosettaNet
في مدخل Microsoft Azure، افتح سير عمل تطبيق Consumption المنطقي في المصمم.
يجب أن يحتوي سير العمل الخاص بك بالفعل على مشغل وأي إجراءات أخرى تريد تشغيلها قبل إضافة إجراء RosettaNet. يستمر هذا المثال مع مشغل الطلب.
ضمن المشغل أو الإجراء، حدد خطوة جديدة.
ضمن مربع البحث Choose an operation، حدد All. في مربع البحث، أدخل rosettanet. من قائمة الإجراءات، حدد الإجراء المسمى RosettaNet Encode.
أدخل المعلومات الخاصة بخصائص الإجراء:
الخاصية المطلوب الوصف رسالة نعم رسالة RosettaNet المراد ترميزها شريك مضيف نعم اسم الشريك المضيف شريك ضيف نعم اسم الشريك الضيف تعليمة PIP البرمجية نعم تعليمة PIP البرمجية إصدار PIP نعم إصدار PIP هوية مثيل PIP نعم المعرف الفريد لرسالة PIP هذه نوع الرسالة نعم نوع الرسالة المراد تشفيرها الدور نعم دور الشريك المضيف الرسالة المشفرة جاهزة الآن للإرسال إلى الشريك.
لإرسال الرسالة المشفرة، يستخدم المثال التالي إجراء HTTP ، الذي تمت إعادة تسميته HTTP - إرسال رسالة مشفرة إلى الشريك.
وفقا لمعايير RosettaNet، تعتبر المعاملات التجارية كاملة فقط عند اكتمال جميع الخطوات المحددة بواسطة PIP.
بعد أن يرسل المضيف الرسالة المشفرة إلى شريك، ينتظر المضيف الإشارة والإقرار. لإنجاز هذه المهمة، أضف الإجراء المسمى RosettaNet انتظر الاستجابة.
تعتمد المدة المراد استخدامها في الانتظار وعدد مرات إعادة المحاولة على تكوين PIP في حساب التكامل الخاص بك. إذا لم يتم تلقي الاستجابة، يتم إنشاء إشعار بالفشل. للتعامل مع عمليات إعادة المحاولة، ضع دائماً الإجراءين Encode وWait for response في التكرار الحلقي Until.
قوالب RosettaNet
لتسريع التطوير والتوصية بأنماط التكامل، يمكنك استخدام قوالب تطبيق منطق الاستهلاك لفك ترميز رسائل RosettaNet وترميزها. عند إنشاء سير عمل تطبيق منطق الاستهلاك، يمكنك التحديد من معرض القوالب في المصمم. يمكنك أيضاً العثور على هذه القوالب في مستودع GitHub لتطبيقات Azure Logic.
