ترميز الملفات الثابتة وفك ترميزها في Azure Logic Apps

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

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

على الرغم من عدم توفر مشغّلات الملف الثابت، يمكنك استخدام أي مشغّل أو إجراء لنقل محتوى XML المصدر إلى سير العمل. على سبيل المثال، يمكنك استخدام مشغّل موصل مضمن أو مشغّل موصل مُدار أو مُستضاف على Azure متوفر لـ Azure Logic Apps أو حتى لتطبيق آخر.

توضح هذه المقالة كيفية إضافة إجراءات ترميز الملف الثابت وفك ترميزه إلى سير العمل.

• أضف إجراء ترميز الملف الثابت أو فك ترميزه إلى سير العمل.
• حدد المخطط الذي تريد استخدامه.

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

• تطبيق منطق "الاستهلاك" مقابل تطبيق منطق "قياسي"
• موصلات حساب التكامل المضمنة
• نظرة عامة على الموصلات المدمجة لتطبيقات Azure Logic
• نظرة عامة على الموصلات المُدارة أو المُستضافة على Azure Logic Apps

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

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

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

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

• مورد تطبيق المنطق وسير العمل. لا تحتوي عمليات الملفات الثابتة على أي مشغّلات متوفرة، لذلك يجب أن يتضمن سير العمل الحد الأدنى من المشغّل. لمزيد من المعلومات، راجع الوثائق التالية:

  • إنشاء مثال سير عمل تطبيق منطق الاستهلاك في تطبيقات Azure Logic Apps متعددة المستأجرين

  • إنشاء مثال لسير عمل تطبيق المنطق القياسي في Azure Logic Apps أحادي المستأجر

• مخطط الملف الثابت لترميز محتوى XML أو فك ترميزه. لمزيد من المعلومات، راجع إضافة مخططات لاستخدامها مع مهام سير العمل في Azure Logic Apps.

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

  هام

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

  • إذا كنت تعمل على سير عمل لتطبيق منطق "الاستهلاك"، فإن مورد تطبيق المنطق يتطلب الربط بحساب التكامل.

  • إذا كنت تعمل على سير عمل لتطبيق منطق "قياسي"، يمكنك ربط حساب التكامل بمورد تطبيق المنطق أو تحميل المخططات مباشرة إلى مورد تطبيق المنطق أو تنفيذ كليهما وفقًا للسيناريوهات التالية:

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

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

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

القيود

• يجب ترميز محتوى XML الذي تريد فك ترميزه بتنسيق UTF-8.

• في مخطط الملف الثابت، تأكد من أن مجموعات XML المضمنة لا تحتوي على أعداد زائدة من الخاصية max count المُعينة إلى قيمة أكبر من 1. تجنب تضمين مجموعة XML بخاصية max count بقيمة أكبر من 1 داخل مجموعة XML أخرى مع خاصية max count أكبر من 1.

• عندما يوزِّع Azure Logic Apps مخطط الملف الثابت، وفي كل مرة يسمح فيها المخطط باختيار الجزء التالي، فإن Azure Logic Apps يُنشئ رمزاً وتوقعاً لهذا الجزء. إذا كان المخطط يسمح بالعديد من مثل هذه البنيات، على سبيل المثال، أكثر من 100,000، يصبح توسيع المخطط كبيراً بشكل مفرط، والذي يستهلك الكثير جداً من الموارد والوقت.

مخطط التحميل

بعد إنشاء المخطط، يجب عليك الآن تحميل المخطط استناداً إلى السيناريو التالي:

• إذا كنت تعمل على سير عمل لتطبيق منطق "الاستهلاك"، فأضف المخطط إلى حساب التكامل.

• إذا كنت تعمل على سير عمل لتطبيق منطق "قياسي"، يمكنك إضافة المخطط إلى حساب التكامل، أو إضافة المخطط إلى مورد تطبيق المنطق.

إضافة إجراء ترميز ملف ثابت

الاستهلاك

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

2. إذا لم يكن لسير العمل مشغّل أو أي إجراءات أخرى يحتاجها سير العمل، فأضف هذه العمليات أولًا. لا تحتوي عمليات "الملف الثابت" على أي مشغّلات متوفرة.

   يستمر هذا المثال مع مشغّل الطلب المُسمى عند تلقي طلب HTTP.

3. في مصمم سير العمل، أسفل الخطوة حيث تريد إضافة إجراء "ملف ثابت"، حدد "خطوة جديدة".

4. ضمن مربع البحث "تحديد عملية"، حدد "الكل". في مربع البحث، أدخل "ملف ثابت".

5. من قائمة الإجراءات، حدد الإجراء المسمى ترميز الملف الثابت.

   

6. في خاصية "محتوى" الخاصة بالإجراء، قدّم إخراج من المشغّل أو إجراء سابق تريد ترميزه باتباع هذه الخطوات:

   1. انقر داخل مربع المحتوى بحيث تظهر قائمة المحتوى الديناميكي.

   2. من قائمة "المحتوى الديناميكي"، حدد محتوى الملف الثابت الذي تريد ترميزه.

      على سبيل المثال، من قائمة "المحتوى الديناميكي"، ضمن "عند تلقي طلب HTTP"، حدد رمز "النص" المميز الذي يمثل إخراج محتوى النص من المشغّل.

   

   إشعار

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

7. حدد المخطط من قائمة "اسم المخطط".

   

   إشعار

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

   يبدو الإجراء عند الانتهاء مشابهاً لما يلي:

   

8. لإضافة معلمات اختيارية أخرى إلى الإجراء، حدد هذه المعلمات من قائمة "إضافة معلمات جديدة".

   المعلمة	قيمة	‏‏الوصف
   وضع إنشاء عقدة فارغة	ForcedDisabled أو HonorSchemaNodeProperty أو ForcedEnabled	وضع الاستخدام لإنشاء عقدة فارغة مع ترميز ملف مسطح. بالنسبة إلى BizTalk، يحتوي مخطط الملف المسطح على خاصية تتحكم في إنشاء عقدة فارغة. يمكنك إما اتباع سلوك خاصية إنشاء العقدة الفارغة لمخطط الملف المسطح، أو يمكنك استخدام هذا الإعداد لجعل Azure Logic Apps تنشئ العقد الفارغة أو تحذفها. لمزيد من المعلومات، راجع علامات العناصر الفارغة.
   تسوية XML	نعم أو لا	الإعداد لتمكين تسوية XML أو تعطيلها في ترميز الملف المسطح. لمزيد من المعلومات، راجع XmlTextReader.Normalization.

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

قياسي

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

2. إذا لم يكن لسير العمل مشغّل أو أي إجراءات أخرى يحتاجها سير العمل، فأضف هذه العمليات أولًا. لا تحتوي عمليات "الملف الثابت" على أي مشغّلات متوفرة.

   يستمر هذا المثال مع مشغّل الطلب المُسمى عند تلقي طلب HTTP.

3. على المصمم، ضمن الخطوة حيث تريد إضافة إجراء "ملف ثابت"، حدد علامة الجمع (+)، ثم حدد "إضافة إجراء".

4. في جزء "إضافة إجراء" الذي يظهر، ضمن مربع البحث، حدد "مضمن".

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

   

6. في خاصية "محتوى" الخاصة بالإجراء، قدّم إخراج من المشغّل أو إجراء سابق تريد ترميزه باتباع هذه الخطوات:

   1. انقر داخل مربع المحتوى بحيث تظهر قائمة المحتوى الديناميكي.

   2. من قائمة "المحتوى الديناميكي"، حدد محتوى الملف الثابت الذي تريد ترميزه.

      على سبيل المثال، من قائمة "المحتوى الديناميكي"، ضمن "عند تلقي طلب HTTP"، حدد رمز "النص" المميز الذي يمثل إخراج محتوى النص من المشغّل.

   

7. من قائمة "المصدر" ، حدد إما "LogicApp" أو "IntegrationAccount" كمصدر المخطط.

   يستمر هذا المثال عن طريق تحديد IntegrationAccount.

   

8. من قائمة الاسم، حدد المخطط الذي قمت بتحميله مسبقاً إلى مورد التطبيق المنطقي الخاص بك للترميز، على سبيل المثال:

   

   إشعار

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

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

إضافة إجراء فك ترميز ملف ثابت

الاستهلاك

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

2. إذا لم يكن لسير العمل مشغّل أو أي إجراءات أخرى يحتاجها سير العمل، فأضف هذه العمليات أولًا. لا تحتوي عمليات "الملف الثابت" على أي مشغّلات متوفرة.

   يستمر هذا المثال مع مشغّل الطلب المُسمى عند تلقي طلب HTTP.

3. في مصمم سير العمل، أسفل الخطوة حيث تريد إضافة إجراء "ملف ثابت"، حدد "خطوة جديدة".

4. ضمن مربع البحث "تحديد عملية"، حدد "الكل". في مربع البحث، أدخل "ملف ثابت".

5. من قائمة الإجراءات، حدد الإجراء المسمى فك ترميز الملف الثابت.

   

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

   1. انقر داخل مربع المحتوى بحيث تظهر قائمة المحتوى الديناميكي.

   2. من قائمة "المحتوى الديناميكي"، حدد محتوى الملف الثابت الذي تريد ترميزه.

      على سبيل المثال، من قائمة "المحتوى الديناميكي"، ضمن "عند تلقي طلب HTTP"، حدد رمز "النص" المميز الذي يمثل إخراج محتوى النص من المشغّل.

   

   إشعار

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

7. حدد المخطط من قائمة "اسم المخطط".

   

   إشعار

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

   يبدو الإجراء عند الانتهاء مشابهاً لما يلي:

   

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

قياسي

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

2. إذا لم يكن لسير العمل مشغّل أو أي إجراءات أخرى يحتاجها سير العمل، فأضف هذه العمليات أولًا. لا تحتوي عمليات "الملف الثابت" على أي مشغّلات متوفرة.

   يستمر هذا المثال مع مشغّل الطلب المُسمى عند تلقي طلب HTTP.

3. على المصمم، ضمن الخطوة حيث تريد إضافة إجراء "ملف ثابت"، حدد علامة الجمع (+)، ثم حدد "إضافة إجراء".

4. في جزء "إضافة إجراء" الذي يظهر، ضمن مربع البحث، حدد "مضمن".

5. في مربع البحث، أدخل "ملف ثابت". من قائمة الإجراءات، حدد الإجراء المسمى فك ترميز الملف الثابت.

   

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

   1. انقر داخل مربع المحتوى بحيث تظهر قائمة المحتوى الديناميكي.

   2. من قائمة "المحتوى الديناميكي"، حدد محتوى الملف الثابت الذي تريد ترميزه.

      على سبيل المثال، من قائمة "المحتوى الديناميكي"، ضمن "عند تلقي طلب HTTP"، حدد رمز "النص" المميز الذي يمثل إخراج محتوى النص من المشغّل.

   

7. من قائمة "المصدر" ، حدد إما "LogicApp" أو "IntegrationAccount" كمصدر المخطط.

   يستمر هذا المثال عن طريق تحديد IntegrationAccount.

   

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

   

   إشعار

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

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

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

• الموصلات المُدارة لـ Azure Logic Apps
• الموصلات المدمجة لـ Azure Logic Apps

اختبار سير العمل

1. باستخدام Postman أو أداة مماثلة وأسلوب POST، أرسل استدعاء إلى عنوان URL لمشغّل "الطلب"، والذي يظهر في الخاصية HTTP POST URL لمشغّل "الطلب"، وأدرِج محتوى XML الذي تريد ترميزه أو فك ترميزه في نص الطلب.

2. بعد انتهاء تشغيل سير العمل، انتقل إلى محفوظات تشغيل سير العمل، وافحص مدخلات إجراء "ملف ثابت" ومخرجاته.

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

• تعرف على المزيد حول حزمة تكامل المؤسسة