تنفيذ عمليات البيانات في Azure Logic Apps

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

يوضح دليل الكيفية هذا كيفية العمل مع البيانات في سير عمل تطبيق المنطق بالطرق التالية:

• إنشاء سلسلة أو كائن JavaScript Object Notation (JSON) من مدخلات متعددة لها أنواع بيانات مختلفة. يمكنك استخدام هذه السلسلة كإدخال واحد، بدلا من إدخال نفس الإدخالات بشكل متكرر أيضًا.
• إنشاء رموز مميزة سهلة الاستخدام من خصائص كائن JavaScript Object Notation (JSON) بحيث يمكنك بسهولة استخدام هذه الخصائص في سير العمل الخاص بك.
• إنشاء جدول HTML أو CSV من صفيف.
• إنشاء صفيف من صفيف آخر استنادا إلى عامل تصفية أو شرط محدد.
• إنشاء صفيف استنادا إلى الخصائص المحددة لكافة العناصر في صفيف آخر.
• إنشاء سلسلة من كافة العناصر في صفيف وفصل هذه العناصر باستخدام حرف محدد.

للحصول على طرق أخرى للعمل مع البيانات، راجع وظائف معالجة البيانات التي توفرها Azure Logic Apps.

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

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

• سير عمل التطبيق المنطقي حيث تريد تنفيذ عملية البيانات. يجب أن يكون لسير العمل هذا مشغل كخطوة أولى في سير العمل. يدعم كل من سير عمل Consumption وStandard logic app عمليات البيانات الموضحة في هذا الدليل.

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

الإجراءات الخاصة بعملية البيانات

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

الإجراءات الخاصة ب JSON

تساعدك الإجراءات التالية على العمل مع البيانات بتنسيق JavaScript Object Notation (JSON).

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

لإنشاء التحويلات الخاصة ب JSON أكثر تعقيدًا، راجع إجراء تحويلات JSON المتقدمة باستخدام قوالب Liquid.

الإجراءات الخاصة بالصفيف

تساعدك الإجراءات التالية على العمل مع البيانات في صفائف.

الإجراء	‏‏الوصف
إنشاء جدول CSV	أنشئ جدول قيمة مفصولة بفواصل (CSV) من صفيف.
إنشاء جدول HTML	أنشئ جدول HTML من صفيف.
تصفية الصفيف	أنشئ مجموعة فرعية صفيف من صفيف استنادا إلى عامل التصفية أو الشرط المحدد.
الانضمام	أنشئ سلسلة من جميع العناصر في مصفوفة وافصل كل عنصر بالحرف المحدد.
Select	أنشئ صفيف من الخصائص المحددة لكافة العناصر في صفيف مختلف.

إجراء الإنشاء

لإنشاء إخراج واحد مثل كائن JSON من مدخلات متعددة، استخدم الإجراء المسمى Compose. تحتوي مدخلاتك على أنواع مختلفة مثل الأعداد الصحيحة والمنطقية والمصفوفات وكائنات JSON وأي نوع أصلي آخر تدعمه تطبيقات Azure Logic، على سبيل المثال ، ثنائي وXML. يمكنك أيضًا استخدام الإخراج في الإجراءات التالية بعد إجراء الإنشاء. يساعدك إجراء الإنشاء أيضا على تجنب إدخال نفس المدخلات بشكل متكرر أثناء إنشاء سير عمل تطبيق المنطق الخاص بك.

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

{ "age": <ageVar>, "fullName": "<lastNameVar>, <firstNameVar>" }

وينشئ الإخراج التالي:

{"age":35,"fullName":"Owens,Sophia"}

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

الاستهلاك

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

   يستخدم هذا المثال مدخل Microsoft Azure ونموذج سير عمل مع مشغل التكرار متبوعا بالعديد من إجراءات تهيئة المتغير . يتم إعداد هذه الإجراءات لإنشاء متغيري سلسلة ومتغير عدد صحيح.

   

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

   • لإضافة الإجراء ضمن الخطوة الأخيرة، حدد خطوة جديدة.

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

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

4. من قائمة الإجراءات، حدد الإجراء المسمى Compose.

   

5. في مربع Inputs ، أدخل المدخلات لاستخدامها في إنشاء الإخراج.

   في هذا المثال، حدد داخل مربع Inputs ، الذي يفتح قائمة المحتوى الديناميكي. من تلك القائمة، حدد المتغيرات التي تم إنشاؤها مسبقا:

   

   تظهر لقطة الشاشة التالية إجراء إنشاء المثال النهائي:

   

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

قياسي

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

   يستخدم هذا المثال مدخل Microsoft Azure ونموذج سير عمل مع مشغل التكرار متبوعا بالعديد من إجراءات تهيئة المتغير . يتم إعداد هذه الإجراءات لإنشاء متغيري سلسلة ومتغير عدد صحيح.

   

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

   • لإضافة إجراء ضمن الخطوة الأخيرة، حدد علامة الجمع (+)، ثم حدد إضافة إجراء.

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

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

   إشعار

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

4. بعد فتح مربع معلومات الإجراء، في مربع Inputs ، أدخل المدخلات لاستخدامها لإنشاء الإخراج.

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

   

   تظهر لقطة الشاشة التالية إجراء إنشاء المثال النهائي:

   

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

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

لتأكيد ما إذا كان الإجراء Join ينشئ النتائج المتوقعة، أرسل لنفسك إعلاما يحتوي علي أخطاراً من إجراءJoin.

الاستهلاك

1. في سير العمل، أضف إجراء يمكن أن يرسل لك النتائج من الإجراء إنشاء .

   يستمر هذا المثال باستخدام إجراء Office 365 Outlook المسمى إرسال بريد إلكتروني.

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

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

   

3. احفظ سير العمل، ثم قم بتشغيل سير العمل يدويا. في شريط أدوات المصمم، حدد تشغيل تشغيل المشغل>.

قياسي

1. في سير العمل، أضف إجراء يمكن أن يرسل لك النتائج من الإجراء إنشاء .

   يستمر هذا المثال باستخدام إجراء Office 365 Outlook المسمى إرسال بريد إلكتروني.

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

   إشعار

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

   

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

   

3. احفظ سير العمل، ثم قم بتشغيل سير العمل يدويا. في قائمة التنقل في سير العمل، حدد Overview>تشغيل المشغل>Run.

إذا استخدمت إجراء Office 365 Outlook، فستحصل على نتيجة مشابهة للقطة الشاشة التالية:

إنشاء الإجراء لجدول CSV

لإنشاء جدول قيمة مفصولة بفواصل (CSV) يحتوي على الخصائص والقيم من كائنات JavaScript Object Notation (JSON) في صفيف، استخدم الإجراء المسمى إنشاء جدول CSV. يمكنك أيضًا استخدام الجدول الناتج في الإجراءات التي تتبع إجراء إنشاء جدول CSV.

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

الاستهلاك

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

   يستخدم هذا المثال مدخل Microsoft Azure ونموذج سير عمل مع مشغل التكرار متبوعا بإجراء تهيئة متغير . تم إعداد الإجراء لإنشاء متغير حيث تكون القيمة الأولية عبارة عن صفيف يحتوي على بعض الخصائص والقيم بتنسيق JSON.

   

2. في سير العمل حيث تريد إنشاء جدول CSV، اتبع إحدى الخطوات التالية:

   • لإضافة الإجراء ضمن الخطوة الأخيرة، حدد خطوة جديدة.

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

3. ضمن مربع البحث "تحديد عملية"، حدد "الكل". في مربع البحث، أدخل إنشاء جدول csv.

4. من قائمة الإجراءات، حدد الإجراء المسمى إنشاء جدول CSV.

   

5. في المربع من، أدخل الصفيف أو التعبير المراد استخدامه لإنشاء الجدول.

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

   

   إشعار

   لإنشاء رموز مميزة سهلة الاستخدام للخصائص في كائنات JSON بحيث يمكنك تحديد هذه الخصائص كمدخلات، استخدم الإجراء المسمى Parse JSON قبل استخدام إجراء إنشاء جدول CSV.

   تظهر لقطة الشاشة التالية المثال النهائي إنشاء إجراء جدول CSV:

   

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

قياسي

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

   يستخدم هذا المثال مدخل Microsoft Azure ونموذج سير عمل مع مشغل التكرار متبوعا بإجراء تهيئة متغير . تم إعداد الإجراء لإنشاء متغير حيث تكون القيمة الأولية عبارة عن صفيف يحتوي على بعض الخصائص والقيم بتنسيق JSON.

   

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

   • لإضافة إجراء ضمن الخطوة الأخيرة، حدد علامة الجمع (+)، ثم حدد إضافة إجراء.

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

3. بعد فتح معرض الموصلات، اتبع هذه الخطوات العامة للعثور على إجراء عمليات البيانات المسمى إنشاء جدول CSV.

4. بعد ظهور مربع معلومات الإجراء، في المربع من ، أدخل الصفيف أو التعبير المراد استخدامه لإنشاء الجدول.

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

   

   إشعار

   لإنشاء رموز مميزة سهلة الاستخدام للخصائص في كائنات JSON بحيث يمكنك تحديد هذه الخصائص كمدخلات، استخدم الإجراء المسمى Parse JSON قبل استخدام إجراء إنشاء جدول CSV.

   تظهر لقطة الشاشة التالية المثال النهائي إنشاء إجراء جدول CSV:

   

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

التخصيص لتنسيق الجدول

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

1. إذا لم تظهر الخاصية Columns في مربع معلومات الإجراء، فمن قائمة Add new parameters، حدد Columns.

2. افتح قائمة Columns، وحدد Custom.

3. في الخاصية Header، حدد نص الرأس المخصص لاستخدامه بدلاً من ذلك.

4. في الخاصية Value، حدد القيمة المخصصة لاستخدامها بدلاً من ذلك.

لإرجاع القيم من الصفيف، يمكنك استخدام الدالةitem() مع الإجراء لإنشاء جدول CSV. التكرار For_each الحلقي، يمكنك استخدام الدالةitems().

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

يقوم هذا المثال بإرجاع النتيجة التالية:

Apples,1
Oranges,2

العمل في طريقة زر العرض الخاصة بالمصمم

في إجراء إنشاء جدول CSV، احتفظ بعمود الرأس فارغا. في كل صف في عمود القيمة، ألغي مرجعية كل خاصية صفيف تريدها. يقوم كل صف ضمن القيمة بإرجاع كافة القيم لخاصية الصفيف المحددة ويصبح عمودا في الجدول المحدد.

الاستهلاك

1. لكل خاصية صفيف تريدها، في عمود القيمة ، حدد داخل مربع التحرير، الذي يفتح قائمة المحتوى الديناميكي.

2. من تلك القائمة، حدد Expression لفتح محرر التعبير بدلا من ذلك.

3. في محرر التعبير، أدخل التعبير التالي ولكن استبدل <array-property-name> باسم خاصية الصفيف للقيمة التي تريدها.

   بناء الجملة: item()?['<array-property-name>']

   أمثلة:

   • item()?['Description']
   • item()?['Product_ID']

   

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

   

5. لحل التعبيرات في إصدارات وصفية أكثر، بدل إلى طريقة عرض التعليمات البرمجية والعودة إلى طريقة عرض المصمم، ثم أعد فتح الإجراء المطوي:

   يظهر إجراء إنشاء جدول CSV الآن مشابها للمثال التالي:

   

قياسي

1. لكل خاصية صفيف تريدها، في العمود القيمة ، حدد داخل مربع التحرير، ثم حدد أيقونة الدالة، التي تفتح محرر التعبير. تأكد من ظهور قائمة Function محددة.

2. في محرر التعبير، أدخل التعبير التالي ولكن استبدل <array-property-name> باسم خاصية الصفيف للقيمة التي تريدها. عند الانتهاء من كل تعبير، حدد إضافة.

   بناء الجملة: item()?['<array-property-name>']

   أمثلة:

   • item()?['Description']
   • item()?['Product_ID']

   

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

   

العمل في طريقة عرض التعليمات البرمجية

في تعريف JSON للإجراء، ضمن الصفيف columns، حدد الخاصية header إلى سلسلة فارغة. لكل خاصية value، قم بإلغاء مرجعية كل خاصية صفيف تريدها.

1. من المصمم، قم بالتبديل إلى طريقة عرض التعليمات البرمجية.

   • الاستهلاك: في شريط أدوات المصمم، حدد طريقة عرض التعليمات البرمجية.
   • قياسي: في قائمة التنقل في سير العمل، ضمن Developer، حدد Code.

2. في محرر التعليمات البرمجية، ابحث عن صفيف الإجراء columns . لكل عمود من قيم الصفيف التي تريدها، أضف خاصية فارغة header والتعبير التالي للخاصية value :

   بناء الجملة:

   {
      "header": "",
      "value": "@item()?['<array-property-name>']"
   }
   

   مثال:

   "Create_CSV_table": {
      "inputs": {
         "columns": [
            { 
               "header": "",
               "value": "@item()?['Description']"
            },
            { 
               "header": "",
               "value": "@item()?['Product_ID']"
            }
         ],
         "format": "CSV",
         "from": "@variables('myJSONArray')"
      }
   }
   

3. قم بالتبديل مرة أخرى إلى طريقة عرض المصمم لمراجعة النتائج.

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

لتأكيد ما إذا كان الإجراء إنشاء جدول CSV بإنشاء النتائج المتوقعة، أرسل لنفسك إعلام يتضمن الإخراج من الإجراء إنشاء جدول CSV.

الاستهلاك

1. في سير العمل، أضف إجراء يمكن أن يرسل لك النتائج من إجراء إنشاء جدول CSV.

   يستمر هذا المثال باستخدام إجراء Office 365 Outlook المسمى إرسال بريد إلكتروني.

2. في هذا الإجراء، لكل مربع تريد ظهور النتائج فيه، حدد داخل المربع، الذي يفتح قائمة المحتوى الديناميكي. ضمن إجراء إنشاء جدول CSV، حدد Output.

   

   إشعار

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

   

3. احفظ سير العمل، ثم قم بتشغيل سير العمل يدويا. في شريط أدوات المصمم، حدد تشغيل تشغيل المشغل>.

قياسي

1. في سير العمل، أضف إجراء يمكن أن يرسل لك النتائج من إجراء إنشاء جدول CSV.

   يستمر هذا المثال باستخدام إجراء Office 365 Outlook المسمى إرسال بريد إلكتروني.

2. في هذا الإجراء، لكل مربع تريد ظهور النتائج فيه، حدد داخل كل مربع، مما يفتح قائمة المحتوى الديناميكي. من تلك القائمة، ضمن إجراء إنشاء جدول CSV، حدد Output.

   

   إشعار

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

   

3. احفظ سير العمل، ثم قم بتشغيل سير العمل يدويا. في قائمة التنقل في سير العمل، حدد Overview>تشغيل المشغل>Run.

إذا استخدمت إجراء Office 365 Outlook، فستحصل على نتيجة مشابهة للقطة الشاشة التالية:

إشعار

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

لإنشاء إجراء جدول HTML

لإنشاء جدول HTML يحتوي على الخصائص والقيم من كائنات تدوين كائن JavaScript (JSON) في صفيف، استخدم الإجراء إنشاء جدول HTML. يمكنك بعد ذلك استخدام الجدول الناتج في الإجراءات التي تتبع الإجراء لإنشاء جدول HTML.

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

الاستهلاك

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

   يستخدم هذا المثال مدخل Microsoft Azure ونموذج سير عمل مع مشغل التكرار متبوعا بإجراء تهيئة متغير . تم إعداد الإجراء لإنشاء متغير حيث تكون القيمة الأولية عبارة عن صفيف يحتوي على بعض الخصائص والقيم بتنسيق JSON.

   

2. في سير العمل حيث تريد إنشاء جدول HTML، اتبع إحدى الخطوات التالية:

   • لإضافة الإجراء ضمن الخطوة الأخيرة، حدد خطوة جديدة.

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

3. ضمن مربع البحث "تحديد عملية"، حدد "الكل". في مربع البحث، أدخل إنشاء جدول html.

4. من قائمة الإجراءات، حدد الإجراء المسمى إنشاء جدول HTML.

   

5. في المربع من، أدخل الصفيف أو التعبير المراد استخدامه لإنشاء الجدول.

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

   

   إشعار

   لإنشاء رموز مميزة سهلة الاستخدام للخصائص في كائنات JSON بحيث يمكنك تحديد هذه الخصائص كإدخالات، استخدم الإجراء المسمى Parse JSON قبل استخدام إجراء إنشاء جدول HTML.

   تظهر لقطة الشاشة التالية المثال النهائي إنشاء إجراء جدول HTML:

   

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

قياسي

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

   يستخدم هذا المثال مدخل Microsoft Azure ونموذج سير عمل مع مشغل التكرار متبوعا بإجراء تهيئة متغير . تم إعداد الإجراء لإنشاء متغير حيث تكون القيمة الأولية عبارة عن صفيف يحتوي على بعض الخصائص والقيم بتنسيق JSON.

   

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

   • لإضافة إجراء ضمن الخطوة الأخيرة، حدد علامة الجمع (+)، ثم حدد إضافة إجراء.

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

3. بعد فتح معرض الموصلات، اتبع هذه الخطوات العامة للعثور على إجراء عمليات البيانات المسمى إنشاء جدول HTML.

4. بعد ظهور مربع معلومات الإجراء، في المربع من ، أدخل الصفيف أو التعبير المراد استخدامه لإنشاء الجدول.

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

   

   إشعار

   لإنشاء رموز مميزة سهلة الاستخدام للخصائص في كائنات JSON بحيث يمكنك تحديد هذه الخصائص كمدخلات، استخدم الإجراء المسمى Parse JSON قبل استخدام إجراء إنشاء جدول CSV.

   تظهر لقطة الشاشة التالية المثال النهائي إنشاء إجراء جدول HTML:

   

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

التخصيص لتنسيق الجدول

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

1. افتح قائمة Columns، وحدد Custom.

2. في الخاصية Header، حدد نص الرأس المخصص لاستخدامه بدلاً من ذلك.

3. في الخاصية Value، حدد القيمة المخصصة لاستخدامها بدلاً من ذلك.

لإرجاع قيم من الصفيف، يمكنك استخدام item() الدالة مع إجراء إنشاء جدول HTML. التكرار For_each الحلقي، يمكنك استخدام الدالةitems().

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

يقوم هذا المثال بإرجاع النتيجة التالية:

Apples,1
Oranges,2

العمل في طريقة زر العرض الخاصة بالمصمم

في إجراء إنشاء جدول HTML، احتفظ بعمود الرأس فارغا. في كل صف في عمود القيمة، ألغي مرجعية كل خاصية صفيف تريدها. يقوم كل صف ضمن القيمة بإرجاع كافة القيم لخاصية الصفيف المحددة ويصبح عمودا في الجدول المحدد.

الاستهلاك

1. لكل خاصية صفيف تريدها، في عمود القيمة ، حدد داخل مربع التحرير، الذي يفتح قائمة المحتوى الديناميكي.

2. من تلك القائمة، حدد Expression لفتح محرر التعبير بدلا من ذلك.

3. في محرر التعبير، أدخل التعبير التالي، ولكن استبدل <array-property-name> باسم خاصية الصفيف للقيمة التي تريدها، ثم حدد موافق. لمزيد من المعلومات، راجع دالة item().

   بناء الجملة: item()?['<array-property-name>']

   أمثلة:

   • item()?['Description']
   • item()?['Product_ID']

   

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

   

5. لحل التعبيرات في إصدارات وصفية أكثر، بدل إلى طريقة عرض التعليمات البرمجية والعودة إلى طريقة عرض المصمم، ثم أعد فتح الإجراء المطوي:

   يظهر إجراء إنشاء جدول HTML الآن مشابها للمثال التالي:

   

قياسي

1. لكل خاصية صفيف تريدها، في العمود القيمة ، حدد داخل مربع التحرير، ثم حدد أيقونة الدالة، التي تفتح محرر التعبير.

2. في محرر التعبير، أدخل التعبير التالي، ولكن استبدل <array-property-name> باسم خاصية الصفيف للقيمة التي تريدها، ثم حدد إضافة. لمزيد من المعلومات، راجع دالة item().

   بناء الجملة: item()?['<array-property-name>']

   أمثلة:

   • item()?['Description']
   • item()?['Product_ID']

   

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

   

العمل في طريقة عرض التعليمات البرمجية

في تعريف JSON للإجراء، ضمن الصفيف columns، حدد الخاصية header إلى سلسلة فارغة. لكل خاصية value، قم بإلغاء مرجعية كل خاصية صفيف تريدها.

1. من المصمم، قم بالتبديل إلى طريقة عرض التعليمات البرمجية.

   • الاستهلاك: في شريط أدوات المصمم، حدد طريقة عرض التعليمات البرمجية.
   • قياسي: في قائمة التنقل في سير العمل، ضمن Developer، حدد Code.

2. في محرر التعليمات البرمجية، ابحث عن صفيف الإجراء columns . لكل عمود من قيم الصفيف التي تريدها، أضف خاصية فارغة header والتعبير التالي للخاصية value :

   بناء الجملة:

   {
      "header": "",
      "value": "@item()?['<array-property-name>']"
   }
   

   مثال:

   "Create_HTML_table": {
      "inputs": {
         "columns": [
            { 
               "header": "",
               "value": "@item()?['Description']"
            },
            { 
               "header": "",
               "value": "@item()?['Product_ID']"
            }
         ],
         "format": "HTML",
         "from": "@variables('myJSONArray')"
      }
   }
   

3. قم بالتبديل مرة أخرى إلى طريقة عرض المصمم لمراجعة النتائج.

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

لتأكيد ما إذا كان الإجراء إنشاء جدول HTML بإنشاء النتائج المتوقعة، أرسل لنفسك إعلام يتضمن الإخراج من الإجراء إنشاء جدول HTML.

الاستهلاك

1. في سير العمل، أضف إجراء يمكنه إرسال النتائج إليك من إجراء إنشاء جدول HTML.

   يستمر هذا المثال باستخدام إجراء Office 365 Outlook المسمى إرسال بريد إلكتروني.

2. في هذا الإجراء، لكل مربع تريد ظهور النتائج فيه، حدد داخل كل مربع، مما يفتح قائمة المحتوى الديناميكي. من تلك القائمة، ضمن إجراء إنشاء جدول HTML، حدد Output.

   

   إشعار

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

     

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

3. احفظ سير العمل، ثم قم بتشغيل سير العمل يدويا. في شريط أدوات المصمم، حدد تشغيل تشغيل المشغل>.

قياسي

1. في سير العمل، أضف إجراء يمكنه إرسال النتائج إليك من إجراء إنشاء جدول HTML.

   يستمر هذا المثال باستخدام إجراء Office 365 Outlook المسمى إرسال بريد إلكتروني.

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

   

   إشعار

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

   

3. احفظ سير العمل، ثم قم بتشغيل سير العمل يدويا. في قائمة التنقل في سير العمل، حدد Overview>تشغيل المشغل>Run.

إذا استخدمت إجراء Office 365 Outlook، فستحصل على نتيجة مشابهة للقطة الشاشة التالية:

إجراء الصفيف لقاعدة التصفية

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

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

إشعار

أي نص عامل علي تصفية تستخدمه في حالتك حساس لحالة الأحرف. لا يمكن لهذا الإجراء تغيير تنسيق العناصر أو مكوناتها في الصفيف أيضا.

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

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

الاستهلاك

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

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

   إشعار

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

   

2. في سير العمل حيث تريد إنشاء الصفيف الذي تمت تصفيته، اتبع إحدى الخطوات التالية:

   • لإضافة الإجراء ضمن الخطوة الأخيرة، حدد خطوة جديدة.

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

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

4. من قائمة الإجراءات، حدد الإجراء المسمى Filter array.

   

5. في المربع من، أدخل الصفيف أو التعبير لاستخدامه كعامل تصفية.

   في هذا المثال، حدد المربع من ، الذي يفتح قائمة المحتوى الديناميكي. من تلك القائمة، حدد المتغير الذي تم إنشاؤه مسبقا:

   

6. بالنسبة للشرط، حدد العناصر الخاصة بالصفيف المراد مقارنتها، وحدد عامل المقارنة، وحدد قيمة المقارنة.

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

   

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

قياسي

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

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

   إشعار

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

   

2. في سير العمل حيث تريد إنشاء الصفيف الذي تمت تصفيته، اتبع إحدى الخطوات التالية:

   • لإضافة إجراء ضمن الخطوة الأخيرة، حدد علامة الجمع (+)، ثم حدد إضافة إجراء.

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

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

4. بعد ظهور مربع معلومات الإجراء، في المربع من ، أدخل الصفيف أو التعبير لاستخدامه كعامل تصفية.

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

   

5. بالنسبة للشرط، حدد العناصر الخاصة بالصفيف المراد مقارنتها، وحدد عامل المقارنة، وحدد قيمة المقارنة.

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

   

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

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

لتأكيد ما إذا كان إجراء صفيف التصفية ينشئ النتائج المتوقعة، أرسل لنفسك إشعارًا يتضمن الإخراج من إجراء صفيف التصفية.

الاستهلاك

1. في سير العمل، أضف إجراء يمكنه إرسال النتائج من إجراء صفيف التصفية.

   يستمر هذا المثال باستخدام إجراء Office 365 Outlook المسمى إرسال بريد إلكتروني.

2. في هذا الإجراء، أكمل الخطوات التالية:

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

   2. من تلك القائمة، حدد Expression لفتح محرر التعبير بدلا من ذلك.

   3. للحصول على إخراج الصفيف من إجراء صفيف التصفية، أدخل التعبير التالي، الذي يستخدم الدالة actionBody() مع اسم إجراء صفيف التصفية، ثم حدد موافق.

      actionBody('Filter_array')

      

      يحدد التعبير الذي تم حله لإظهار المخرجات من الإجراء Filter_array في نص البريد الإلكتروني عند إرساله:

      

3. احفظ سير العمل، ثم قم بتشغيل سير العمل يدويا. في شريط أدوات المصمم، حدد تشغيل تشغيل المشغل>.

قياسي

1. في سير العمل، أضف إجراء يمكنه إرسال النتائج من إجراء صفيف التصفية.

2. في هذا الإجراء، أكمل الخطوات التالية:

   1. لكل مربع تريد ظهور النتائج فيه، حدد داخل المربع، ثم حدد أيقونة الدالة، التي تفتح محرر التعبير. تأكد من ظهور قائمة Function محددة.

   2. للحصول على إخراج الصفيف من إجراء صفيف التصفية، أدخل التعبير التالي، الذي يستخدم الدالة actionBody() مع اسم إجراء صفيف التصفية، ثم حدد موافق.

      actionBody('Filter_array')

      

      يحدد التعبير الذي تم حله لإظهار المخرجات من الإجراء Filter_array في نص البريد الإلكتروني عند إرساله:

      

3. احفظ سير العمل، ثم قم بتشغيل سير العمل يدويا. في قائمة التنقل في سير العمل، حدد Overview>تشغيل المشغل>Run.

إذا استخدمت إجراء Office 365 Outlook، فستحصل على نتيجة مشابهة للقطة الشاشة التالية:

إجراء الانضمام

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

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

الاستهلاك

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

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

   

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

   • لإضافة الإجراء ضمن الخطوة الأخيرة، حدد خطوة جديدة.

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

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

4. من قائمة الإجراءات، حدد الإجراء المسمى الانضمام.

   

5. في المربع من، أدخل الصفيف الذي يحتوي على العناصر التي تريد ضمها كسلسلة.

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

   

6. في المربع الانضمام مع ، أدخل الحرف المراد استخدامه لفصل كل عنصر صفيف.

   يستخدم هذا المثال نقطتين (:) كفاصل.

   

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

قياسي

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

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

   

2. في سير العمل حيث تريد إنشاء الصفيف الذي تمت تصفيته، اتبع إحدى الخطوات التالية:

   • لإضافة إجراء ضمن الخطوة الأخيرة، حدد علامة الجمع (+)، ثم حدد إضافة إجراء.

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

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

4. بعد ظهور مربع معلومات الإجراء، في المربع من ، أدخل الصفيف الذي يحتوي على العناصر التي تريد الانضمام إليها كسلسلة.

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

   

5. في المربع الانضمام مع ، أدخل الحرف المراد استخدامه لفصل كل عنصر صفيف.

   يستخدم هذا المثال نقطتين (:) كفاصل.

   

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

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

لتأكيد ما إذا كان الإجراء Join ينشئ النتائج المتوقعة، أرسل لنفسك إعلامًا يتضمن إخطارًا من إجراءJoin.

الاستهلاك

1. في سير العمل، أضف إجراء يمكن أن يرسل لك النتائج من إجراء الانضمام .

   يستمر هذا المثال باستخدام إجراء Office 365 Outlook المسمى إرسال بريد إلكتروني.

2. في هذا الإجراء، لكل مربع تريد ظهور النتائج فيه، حدد داخل كل مربع، مما يفتح قائمة المحتوى الديناميكي. من تلك القائمة، ضمن إجراء الانضمام ، حدد الإخراج.

   

   إشعار

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

   

3. احفظ سير العمل، ثم قم بتشغيل سير العمل يدويا. في شريط أدوات المصمم، حدد تشغيل تشغيل المشغل>.

قياسي

1. في سير العمل، أضف إجراء يمكن أن يرسل لك النتائج من إجراء الانضمام .

   يستمر هذا المثال باستخدام إجراء Office 365 Outlook المسمى إرسال بريد إلكتروني.

2. في هذا الإجراء، لكل مربع تريد ظهور النتائج فيه، حدد داخل كل مربع، مما يفتح قائمة المحتوى الديناميكي. من تلك القائمة، ضمن إجراء الانضمام ، حدد الإخراج.

   

   إشعار

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

   

3. احفظ سير العمل، ثم قم بتشغيل سير العمل يدويا. في قائمة التنقل في سير العمل، حدد Overview>تشغيل المشغل>Run.

إذا استخدمت إجراء Office 365 Outlook، فستحصل على نتيجة مشابهة للقطة الشاشة التالية:

إجراء تحليل JSON

للإشارة إلى خصائص أو الوصول إليها في محتوى JavaScript Object Notation (JSON)، يمكنك إنشاء حقول أو رموز مميزة سهلة الاستخدام لتلك الخصائص عن طريق استخدام إجراء Parse JSON. وبهذه الطريقة، يمكنك تحديد هذه الخصائص من قائمة المحتوى الديناميكي عند تحديد مدخلات للإجراءات اللاحقة في سير العمل. لهذا الإجراء، يمكنك إما توفير مخطط JSON أو إنشاء مخطط JSON من عينة المحتوى الخاص بـ JSON أو البيانات الأساسية.

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

الاستهلاك

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

   يستخدم هذا المثال مدخل Microsoft Azure ونموذج سير عمل مع مشغل تكرار متبوعا بإجراء تهيئة متغير . تم إعداد هذا الإجراء لإنشاء متغير قيمته الأولية هي كائن JSON التالي مع الخصائص والقيم:

   {
       "Member": {
           "Email": "Sophia.Owen@fabrikam.com",
           "FirstName": "Sophia",
           "LastName": "Owen"
       }
   }
   

   

2. في سير العمل حيث تريد تحليل كائن JSON، اتبع إحدى الخطوات التالية:

   • لإضافة الإجراء ضمن الخطوة الأخيرة، حدد خطوة جديدة.

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

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

4. من قائمة الإجراءات، حدد الإجراء المسمى Parse JSON.

   

5. في مربع المحتوى ، أدخل كائن JSON الذي تريد تحليله.

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

   

6. في مربع المخطط ، أدخل مخطط JSON الذي يصف كائن JSON أو الحمولة التي تريد تحليلها.

   في هذا المثال، استخدم المخطط التالي لعنصر JSON النموذجي:

   {
       "type": "object",
       "properties": {
           "Member": {
               "type": "object",
               "properties": {
                   "Email": {
                       "type": "string"
                   },
                   "FirstName": {
                       "type": "string"
                   },
                   "LastName": {
                       "type": "string"
                   }
               }
           }
       }
   }
   

   

   إذا لم يكن لديك مخطط، يمكنك إنشاء المخطط من كائن JSON:

   1. في إجراء تحليل JSON ، ضمن مربع المخطط ، حدد استخدام حمولة العينة لإنشاء مخطط.

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

      {
          "Member": {
             "Email": "Sophia.Owen@fabrikam.com",
             "FirstName": "Sophia",
             "LastName": "Owen"
          }
      }
      

      

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

قياسي

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

   يستخدم هذا المثال مدخل Microsoft Azure ونموذج سير عمل مع مشغل تكرار متبوعا بإجراء تهيئة متغير . تم إعداد هذا الإجراء لإنشاء متغير قيمته الأولية هي كائن JSON التالي مع الخصائص والقيم:

   {
       "Member": {
           "Email": "Sophia.Owen@fabrikam.com",
           "FirstName": "Sophia",
           "LastName": "Owen"
       }
   }
   

   

2. في سير العمل حيث تريد تحليل كائن JSON، اتبع إحدى الخطوات التالية:

   • لإضافة إجراء ضمن الخطوة الأخيرة، حدد علامة الجمع (+)، ثم حدد إضافة إجراء.

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

3. بعد فتح معرض الموصلات، اتبع هذه الخطوات العامة للعثور على إجراء عمليات البيانات المسمى تحليل JSON.

4. بعد ظهور مربع معلومات الإجراء، في المربع المحتوى ، أدخل كائن JSON الذي تريد تحليله.

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

   

5. في مربع المخطط ، أدخل مخطط JSON الذي يصف كائن JSON أو الحمولة. التي تريد تحليلها.

   في هذا المثال، استخدم المخطط التالي لعنصر JSON النموذجي:

   {
       "type": "object",
       "properties": {
           "Member": {
               "type": "object",
               "properties": {
                   "Email": {
                       "type": "string"
                   },
                   "FirstName": {
                       "type": "string"
                   },
                   "LastName": {
                       "type": "string"
                   }
               }
           }
       }
   }
   

   

   إذا لم يكن لديك مخطط، يمكنك إنشاء المخطط من كائن JSON:

   1. في إجراء تحليل JSON ، ضمن مربع المخطط ، حدد استخدام حمولة العينة لإنشاء مخطط.

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

      {
          "Member": {
             "Email": "Sophia.Owen@fabrikam.com",
             "FirstName": "Sophia",
             "LastName": "Owen"
          }
      }
      

      

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

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

لتأكيد ما إذا كان الإجراء Parse JSON ينشئ النتائج المتوقعة، أرسل لنفسك إعلاما يتضمن إخطارًا من إجراءParse JSON.

الاستهلاك

1. في سير العمل الخاص بك، أضف إجراء يمكن أن يرسل لك النتائج من إجراء تحليل JSON .

   يستمر هذا المثال باستخدام إجراء Office 365 Outlook المسمى إرسال بريد إلكتروني.

2. في هذا الإجراء، لكل مربع تحرير تريد ظهور النتائج فيه، حدد داخل كل مربع، الذي يفتح قائمة المحتوى الديناميكي. من تلك القائمة، ضمن إجراء Parse JSON ، يمكنك الآن تحديد الخصائص من كائن JSON الذي تم تحليله.

   يحدد هذا المثال الخصائص التالية: FirstName وLastName و Email

   

   إشعار

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

   

   عند الانتهاء، يبدو إجراء إرسال بريد إلكتروني مشابها للمثال التالي:

   

3. احفظ سير العمل، ثم قم بتشغيل سير العمل يدويا. في شريط أدوات المصمم، حدد تشغيل تشغيل المشغل>.

قياسي

1. في سير العمل الخاص بك، أضف إجراء يمكن أن يرسل لك النتائج من إجراء تحليل JSON .

   يستمر هذا المثال باستخدام إجراء Office 365 Outlook المسمى إرسال بريد إلكتروني.

2. في هذا الإجراء، لكل مربع تريد ظهور النتائج فيه، حدد داخل كل مربع تحرير، والذي يفتح قائمة المحتوى الديناميكي. من تلك القائمة، ضمن إجراء Parse JSON ، يمكنك الآن تحديد الخصائص من كائن JSON الذي تم تحليله.

   يحدد هذا المثال الخصائص التالية: FirstName وLastName و Email

   

   إشعار

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

   

   عند الانتهاء، يبدو إجراء إرسال بريد إلكتروني مشابها للمثال التالي:

   

3. احفظ سير العمل، ثم قم بتشغيل سير العمل يدويا. في قائمة التنقل في سير العمل، حدد Overview>تشغيل المشغل>Run.

إذا استخدمت إجراء Office 365 Outlook، فستحصل على نتيجة مشابهة للقطة الشاشة التالية:

تحديد إجراء

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

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

تلميح

للحصول على مثال ينشئ صفيفا بسلاسل أو أعداد صحيحة مبنية من القيم في صفيف كائن JSON، راجع تعريفات الإجراء المتغير Select and Initliaze في أمثلة التعليمات البرمجية لعملية البيانات - Select.

الاستهلاك

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

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

   

2. في سير العمل حيث تريد إنشاء صفيف كائن JSON، اتبع إحدى الخطوات التالية:

   • لإضافة الإجراء ضمن الخطوة الأخيرة، حدد خطوة جديدة.

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

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

4. من قائمة الإجراءات، حدد الإجراء المسمى Select.

   

5. في المربع من ، أدخل الصفيف المصدر الذي تريد استخدامه.

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

   

6. بالنسبة للخاصية Map ، في العمود الأيسر، أدخل اسم خاصية لوصف كافة القيم في الصفيف المصدر.

   يستخدم هذا المثال Product_ID كاسم خاصية لقيم العدد الصحيح في الصفيف المصدر. لذلك، كل قيمة، على سبيل المثال، 1 و2 و3 و4، هي معرف منتج.

7. في العمود الأيسر، أدخل تعبيرا يحدد القيمة في الصفيف المصدر لاسم الخاصية في العمود الأيسر.

   يستخدم هذا المثال الدالة item() للتكرار والوصول إلى كل عنصر في الصفيف.

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

   2. من تلك القائمة، حدد Expression لفتح محرر التعبير بدلا من ذلك.

   3. في محرر التعبير، أدخل الدالة المسماة item()، ثم حدد OK.

   

   يظهر الإجراء Select الآن مشابها للمثال التالي:

   

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

قياسي

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

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

   

2. في سير العمل حيث تريد إنشاء صفيف كائن JSON، اتبع إحدى الخطوات التالية:

   • لإضافة إجراء ضمن الخطوة الأخيرة، حدد علامة الجمع (+)، ثم حدد إضافة إجراء.

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

3. بعد فتح معرض الموصلات، اتبع هذه الخطوات العامة للعثور على إجراء عمليات البيانات المسمى Select.

4. بعد ظهور مربع معلومات الإجراء، في المربع من ، أدخل الصفيف المصدر الذي تريد استخدامه.

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

   

5. بالنسبة للخاصية Map ، في العمود الأيسر، أدخل اسم خاصية لوصف كافة القيم في الصفيف المصدر.

   يستخدم هذا المثال Product_ID كاسم خاصية لقيم العدد الصحيح في الصفيف المصدر. لذلك، كل قيمة، على سبيل المثال، 1 و2 و3 و4، هي معرف منتج.

6. في العمود الأيسر، أدخل تعبيرا يحدد القيمة في الصفيف المصدر لاسم الخاصية في العمود الأيسر.

   يستخدم هذا المثال الدالة item() للتكرار والوصول إلى كل عنصر في الصفيف.

   1. حدد داخل العمود الأيسر، ثم حدد أيقونة الدالة، التي تفتح محرر التعبير. تأكد من ظهور قائمة Function محددة.

   2. في محرر التعبير، أدخل الدالة المسماة item()، ثم حدد Add.

   

   يظهر الإجراء Select الآن مشابها للمثال التالي:

   

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

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

لتأكيد ما إذا كان الإجراء Select ينشئ النتائج المتوقعة، أرسل لنفسك إعلاما يتضمن إخطارًا من إجراءSelect.

الاستهلاك

1. في سير العمل، أضف إجراء يمكنه إرسال النتائج إليك من الإجراء تحديد .

   يستمر هذا المثال باستخدام إجراء Office 365 Outlook المسمى إرسال بريد إلكتروني.

2. في هذا الإجراء، أكمل الخطوات التالية:

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

   2. من تلك القائمة، حدد Expression لفتح محرر التعبير بدلا من ذلك.

   3. للحصول على إخراج الصفيف من الإجراء Select، أدخل التعبير التالي، الذي يستخدم الدالة actionBody() مع اسم الإجراء Select، وحدد OK:

      actionBody('Select')

      

      يحدد التعبير الذي تم حله لإظهار المخرجات من الإجراء تحديد في نص البريد الإلكتروني عند إرساله:

      

   عند الانتهاء، يبدو إجراء إرسال بريد إلكتروني مشابها للمثال التالي:

3. احفظ سير العمل، ثم قم بتشغيل سير العمل يدويا. في شريط أدوات المصمم، حدد تشغيل تشغيل المشغل>.

قياسي

1. في سير العمل، أضف إجراء يمكنه إرسال النتائج إليك من الإجراء تحديد .

2. في هذا الإجراء، أكمل الخطوات التالية:

   1. لكل مربع تريد ظهور النتائج فيه، حدد داخل كل مربع، ثم حدد أيقونة الدالة، التي تفتح محرر التعبير. تأكد من ظهور قائمة Function محددة.

   2. للحصول على إخراج الصفيف من الإجراء Select، أدخل التعبير التالي، الذي يستخدم الدالة actionBody() مع اسم الإجراء Select، وحدد OK:

      actionBody('Select')

      

      يحدد التعبير الذي تم حله لإظهار المخرجات من الإجراء Filter_array في نص البريد الإلكتروني عند إرساله:

      

3. احفظ سير العمل، ثم قم بتشغيل سير العمل يدويا. في قائمة التنقل في سير العمل، حدد Overview>تشغيل المشغل>Run.

إذا استخدمت إجراء Office 365 Outlook، فستحصل على نتيجة مشابهة للقطة الشاشة التالية:

استكشاف الأخطاء وإصلاحها

تنسيق بيانات الجدول

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

التنسيق غير صحيح.

Fruit,Number Apples,1 Oranges,2

التنسيق صحيح.

Fruit,Number
Apples,1
Oranges,2

لإضافة فواصل أسطر بين الصفوف، قم بإضافة أحد التعبيرات التالية إلى الجدول:

replace(body('Create_CSV_table'),'','<br/>')

replace(body('Create_HTML_table'),'','<br/>')

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

{
	"Send_an_email_": {
		"inputs": {
			"body": {
				"Body": "<p>Results from Create CSV table action:<br/>\n<br/>\n<br/>\n@{replace(body('Create_CSV_table'),'\r\n','<br/>')}</p>",
				"Subject": "Create CSV table results",
				"To": "sophia.owen@fabrikam.com"
			}
		}
	}
}

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

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