تشفير الملفات المسطحة وفك تشفيرها في تطبيقات Azure المنطقية

قبل إرسال محتوى XML إلى شريك أعمال في سيناريو بين الشركات (B2B)، قد تحتاج إلى ترميز هذا المحتوى أولا. من خلال إنشاء سير عمل تطبيق منطقي، يمكنك ترميز الملفات المسطحة وفك تشفيرها باستخدام إجراءات الملف المسطح المضمنة.

على الرغم من عدم توفر مشغلات "ملف مسطح "، يمكنك استخدام مشغل أو إجراء مختلف للحصول على محتوى XML أو تغذيته من مصادر مختلفة في سير العمل الخاص بك للترميز أو فك التشفير. على سبيل المثال، يمكنك استخدام مشغل الطلب أو تطبيق آخر أو موصلات أخرى تدعمها تطبيقات Azure Logic Apps. يمكنك استخدام إجراءات "الملف المسطح" مع مهام سير العمل في أنواع موارد تطبيق المنطق (الاستهلاك)والتطبيق المنطقي (قياسي).

ملاحظة

بالنسبة إلى تطبيق المنطق (قياسي)، تكون إجراءات الملف المسطح قيد المعاينة حاليا.

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

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

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

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

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

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

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

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

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

      ملاحظة

      حاليا، يدعم نوع مورد تطبيق المنطق (الاستهلاك) فقط عمليات RosettaNet . لا يتضمن نوع مورد تطبيق المنطق (القياسي) عمليات RosettaNet .

  • سير عمل التطبيق المنطقي، فارغ أو موجود، حيث تريد استخدام الإجراء ملف مسطح .

    إذا كان لديك سير عمل فارغ، فاستخدم أي مشغل تريد بدء سير العمل. يستخدم هذا المثال مشغل الطلب.

الحدود

تأكد من أن مجموعات XML المضمنة في مخطط الملف المسطح الذي تقوم بإنشائه لا تحتوي على أعداد زائدة من الخاصية المعينة max count إلى قيمة أكبر من 1. تجنب تداخل مجموعة XML بقيمة خاصية max count أكبر من 1 داخل مجموعة XML أخرى ذات خاصية max count أكبر من 1.

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

إجراء إضافة ترميز ملف مسطح

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

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

    يستخدم هذا المثال مشغل الطلب، الذي يسمى عند تلقي طلب HTTP، ويعالج الطلبات الواردة من خارج سير عمل التطبيق المنطقي. لإضافة مشغل الطلب، اتبع الخطوات التالية:

    1. ضمن مربع البحث عن المصمم، حدد مضمن. في مربع البحث عن المصمم، أدخل HTTP request.

    2. من قائمة المشغلات، حدد مشغل الطلب المسمى عند استلام طلب HTTP.

    تلميح

    يعد توفير مخطط JSON أمرا اختياريا. إذا كان لديك عينة حمولة من الطلب الوارد، فحدد استخدام عينة الحمولة لإنشاء مخطط، وأدخل الحمولة الصافية للعينة، وحدد تم. يظهر المخطط في المربع مخطط JSON لنص الطلب.

  3. ضمن الخطوة في سير العمل حيث تريد إضافة الإجراء ترميز الملفات المسطحة ، حدد خيارا:

    • لإضافة إجراء ترميز الملفات المسطحة في نهاية سير العمل، حدد خطوة جديدة.

    • لإضافة إجراء ترميز الملف المسطح بين الخطوات الموجودة، حرك المؤشر فوق السهم الذي يربط تلك الخطوات بحيث تظهر علامة الجمع (+) . حدد علامة الجمع هذه، ثم حدد إضافة إجراء.

  4. في مربع اختيار عملية البحث، أدخل flat file. من قائمة الإجراءات، حدد الإجراء المسمى ترميز الملفات المسطحة.

    Screenshot showing the Azure portal and Consumption designer with

  5. انقر داخل مربع المحتوى بحيث تظهر قائمة المحتوى الديناميكي. من القائمة، في القسم عند استلام طلب HTTP ، حدد الخاصية النص ، التي تحتوي على إخراج نص الطلب من المشغل والمحتوى المراد ترميزه.

    Screenshot showing the Consumption designer and the

    تلميح

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

  6. من القائمة اسم المخطط ، حدد المخطط الموجود في حساب التكامل المرتبط لاستخدامه في الترميز، على سبيل المثال:

    Screenshot showing the Consumption designer and the opened

    ملاحظة

    إذا لم يظهر أي مخطط في القائمة، فلن يحتوي حساب التكامل الخاص بك على أي ملفات مخطط لاستخدامها في الترميز. Upload المخطط الذي تريد استخدامه في حساب التكامل الخاص بك.

  7. احفظ سير عملك. في شريط أدوات المصمم، حدد "Save" .

  8. لاختبار سير العمل، أرسل طلبا إلى نقطة نهاية HTTPS، التي تظهر في خاصية HTTP POST URL الخاصة بمشغل الطلب، وقم بتضمين محتوى XML الذي تريد ترميزه في نص الطلب.

لقد انتهيت الآن من إعداد إجراء ترميز الملف المسطح. في تطبيق العالم الحقيقي، قد ترغب في تخزين البيانات المشفرة في تطبيق خط عمل (LOB)، مثل Salesforce. أو يمكنك إرسال البيانات المشفرة إلى شريك تجاري. لإرسال الإخراج من إجراء الترميز إلى Salesforce أو إلى شريكك التجاري، استخدم الموصلات الأخرى المتوفرة في Azure Logic Apps.

إضافة إجراء فك تشفير الملفات المسطحة

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

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

    يستخدم هذا المثال مشغل الطلب، الذي يسمى عند تلقي طلب HTTP، ويعالج الطلبات الواردة من خارج سير عمل التطبيق المنطقي. لإضافة مشغل الطلب، اتبع الخطوات التالية:

    1. ضمن مربع البحث عن المصمم، حدد مضمن. في مربع البحث عن المصمم، أدخل HTTP request.

    2. من قائمة المشغلات، حدد مشغل الطلب المسمى عند استلام طلب HTTP.

    تلميح

    يعد توفير مخطط JSON أمرا اختياريا. إذا كان لديك عينة حمولة من الطلب الوارد، فحدد استخدام عينة الحمولة لإنشاء مخطط، وأدخل الحمولة الصافية للعينة، وحدد تم. يظهر المخطط في المربع مخطط JSON لنص الطلب.

  3. ضمن الخطوة في سير العمل حيث تريد إضافة الإجراء فك تشفير الملفات المسطحة ، حدد خيارا:

    • لإضافة إجراء فك تشفير الملفات المسطحة في نهاية سير العمل، حدد خطوة جديدة.

    • لإضافة إجراء فك تشفير الملفات المسطحة بين الخطوات الموجودة، حرك المؤشر فوق السهم الذي يربط تلك الخطوات بحيث تظهر علامة الجمع (+) . حدد علامة الجمع هذه، ثم حدد إضافة إجراء.

  4. في مربع اختيار عملية البحث، أدخل flat file. من قائمة الإجراءات، حدد الإجراء المسمى فك تشفير الملفات المسطحة.

    Screenshot showing the Azure portal and the Consumption designer with

  5. انقر داخل مربع المحتوى بحيث تظهر قائمة المحتوى الديناميكي. من القائمة، في القسم عند استلام طلب HTTP ، حدد الخاصية النص ، التي تحتوي على إخراج نص الطلب من المشغل والمحتوى المراد فك تشفيره.

    Screenshot showing the Consumption designer and the

    تلميح

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

  6. من القائمة اسم المخطط ، حدد المخطط الموجود في حساب التكامل المرتبط لاستخدامه لفك التشفير، على سبيل المثال:

    Screenshot showing the Consumption designer and the opened

    ملاحظة

    إذا لم يظهر أي مخطط في القائمة، فلن يحتوي حساب التكامل الخاص بك على أي ملفات مخطط لاستخدامها في فك التشفير. Upload المخطط الذي تريد استخدامه في حساب التكامل الخاص بك.

  7. احفظ سير عملك. في شريط أدوات المصمم، حدد "Save" .

  8. لاختبار سير العمل، أرسل طلبا إلى نقطة نهاية HTTPS، التي تظهر في خاصية HTTP POST URL الخاصة بمشغل الطلب، وقم بتضمين محتوى XML الذي تريد فك تشفيره في نص الطلب.

لقد انتهيت الآن من إعداد إجراء فك تشفير الملف المسطح. في تطبيق العالم الحقيقي، قد ترغب في تخزين البيانات التي تم فك تشفيرها في تطبيق خط العمل (LOB)، مثل Salesforce. أو يمكنك إرسال البيانات التي تم فك تشفيرها إلى شريك تجاري. لإرسال الإخراج من إجراء فك التشفير إلى Salesforce أو إلى شريكك التجاري، استخدم الموصلات الأخرى المتوفرة في Azure Logic Apps.

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