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

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

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

إذا لم تعثر على الإجراء الذي تريده هنا، فحاول استعراض العديد من وظائف معالجة البيانات المختلفة التي توفرها تطبيقات Azure Logic Apps.

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

إجراءات تشغيل البيانات

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

إجراءات الصفيف

تساعدك هذه الإجراءات على استخدام البيانات في الصفيفات.

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

إجراءات JSON

تساعدك هذه الإجراءات على التعامل مع البيانات بتنسيق تدوين كائن جافا سكريبت (JSON).

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

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

إنشاء عمل

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

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

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

ويخلق هذا الإخراج:

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

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

  1. في مدخل Azure أو Visual Studio، افتح تطبيقك المنطقي في Logic App Designer.

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

    Starting sample logic app for

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

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

      Select

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

  3. ضمن Choose an action، في مربع البحث، أدخل compose بصفته عامل تصفيتك. من قائمة الإجراءات، حدد الإجراء إنشاء .

    Select

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

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

    Select inputs to use for

    فيما يلي المثال النهائي إنشاء إجراء:

    Finished example for

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

لمزيد من المعلومات حول هذا الإجراء في تعريف سير العمل الأساسي، راجع الإجراء إنشاء.

اختبر تطبيق المنطق الخاص بك

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

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

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

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

  3. الآن ، قم بتشغيل تطبيق المنطق يدويا. على شريط أدوات المصمم، حدد تشغيل.

    استنادا إلى موصل البريد الإلكتروني الذي استخدمته، إليك النتائج التي تحصل عليها:

    Email with

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

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

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

  1. في مدخل Azure أو Visual Studio، افتح تطبيقك المنطقي في Logic App Designer.

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

    Starting sample logic app for

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

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

      Select

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

  3. ضمن Choose an action، في مربع البحث، أدخل create csv table بصفته عامل تصفيتك. من قائمة الإجراءات، حدد الإجراء إنشاء جدول CSV .

    Select

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

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

    Select array output for creating CSV table

    تلميح

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

    فيما يلي المثال النهائي إنشاء إجراء جدول CSV :

    Finished example for

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

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

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

  1. افتح قائمة الأعمدة ، وحدد مخصص.

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

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

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

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

Apples,1
Oranges,2

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

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

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

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

  3. في محرر التعبير، أدخل هذا التعبير الذي يحدد قيمة خاصية الصفيف التي تريدها، وحدد موافق.

    item()?['<array-property-name>']

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

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

    Dereference

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

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

    يظهر الإجراء إنشاء جدول CSV الآن على النحو التالي:

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

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

  1. على شريط أدوات المصمم، حدد طريقة عرض التعليمات البرمجية.

  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 ينشئ النتائج المتوقعة، أرسل لنفسك إشعارا يتضمن مخرجات من الإجراء إنشاء جدول CSV.

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

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

    يستخدم هذا المثال الإجراء Office 365 Outlook إرسال بريد إلكتروني ويتضمن حقل الإخراج في نص البريد الإلكتروني:

    ملاحظة

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

  3. الآن ، قم بتشغيل تطبيق المنطق يدويا. على شريط أدوات المصمم، حدد تشغيل.

    استنادا إلى موصل البريد الإلكتروني الذي استخدمته، إليك النتائج التي تحصل عليها:

    Email with

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

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

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

  1. في مدخل Azure أو Visual Studio، افتح تطبيقك المنطقي في Logic App Designer.

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

    Starting sample logic app for

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

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

      Select

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

  3. ضمن Choose an action، في مربع البحث، أدخل create html table بصفته عامل تصفيتك. من قائمة الإجراءات، حدد الإجراء إنشاء جدول HTML .

    Select

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

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

    Select array output for creating HTML table

    تلميح

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

    فيما يلي المثال النهائي إنشاء إجراء جدول HTML :

    Finished example for

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

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

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

  1. افتح قائمة الأعمدة ، وحدد مخصص.

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

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

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

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

Apples,1
Oranges,2

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

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

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

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

  3. في محرر التعبير، أدخل هذا التعبير الذي يحدد قيمة خاصية الصفيف التي تريدها، وحدد موافق.

    item()?['<array-property-name>']

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

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

    Dereference property in

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

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

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

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

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

  1. على شريط أدوات المصمم، حدد طريقة عرض التعليمات البرمجية.

  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 ينشئ النتائج المتوقعة، أرسل لنفسك إعلاما يتضمن مخرجات من الإجراء إنشاء جدول HTML .

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

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

    يستخدم هذا المثال الإجراء Office 365 Outlook إرسال بريد إلكتروني ويتضمن حقل الإخراج في نص البريد الإلكتروني:

    ملاحظة

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

    ملاحظة

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

  3. الآن ، قم بتشغيل تطبيق المنطق يدويا. على شريط أدوات المصمم، حدد تشغيل.

    استنادا إلى موصل البريد الإلكتروني الذي استخدمته، إليك النتائج التي تحصل عليها:

    Email with

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

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

ملاحظة

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

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

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

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

  1. في مدخل Azure أو Visual Studio، افتح تطبيقك المنطقي في Logic App Designer.

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

    ملاحظة

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

    Starting sample logic app for

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

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

      Select

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

  3. في مربع البحث، أدخل filter array كفلتر. من قائمة الإجراءات، حدد إجراء تصفية الصفيف .

    Select

  4. في المربع من ، قم بتوفير الصفيف أو التعبير الذي تريد تصفيته.

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

    Select array output for creating filtered array

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

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

    Finished example for

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

لمزيد من المعلومات حول هذا الإجراء في تعريف سير العمل الأساسي، راجع إجراء الاستعلام.

اختبر تطبيق المنطق الخاص بك

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

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

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

    @actionBody('Filter_array')

    يستخدم هذا المثال الإجراء Office 365 Outlook إرسال بريد إلكتروني ويتضمن المخرجات من تعبير actionBody('Filter_array') في نص الرسالة الإلكترونية:

    Action outputs from

  3. الآن ، قم بتشغيل تطبيق المنطق يدويا. على شريط أدوات المصمم، حدد تشغيل.

    استنادا إلى موصل البريد الإلكتروني الذي استخدمته، إليك النتائج التي تحصل عليها:

    Email with

انضم إلى العمل

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

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

  1. في مدخل Azure أو Visual Studio، افتح تطبيقك المنطقي في Logic App Designer.

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

    Starting sample logic app for

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

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

      SSelect

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

  3. في مربع البحث، أدخل join كفلتر. من قائمة الإجراءات، حدد هذا الإجراء: الانضمام

    Select

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

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

    Select array output for creating the string

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

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

    Provide the separator character

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

لمزيد من المعلومات حول هذا الإجراء في تعريف سير العمل الأساسي، راجع الإجراء انضمام.

اختبر تطبيق المنطق الخاص بك

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

  1. في تطبيق المنطق، أضف إجراء يمكنه إرسال النتائج من الإجراء انضمام إليك .

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

    يستخدم هذا المثال الإجراء Office 365 Outlook إرسال بريد إلكتروني ويتضمن حقل الإخراج في نص البريد الإلكتروني:

  3. الآن ، قم بتشغيل تطبيق المنطق يدويا. على شريط أدوات المصمم، حدد تشغيل.

    استنادا إلى موصل البريد الإلكتروني الذي استخدمته، إليك النتائج التي تحصل عليها:

    Email with

تحليل عمل JSON

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

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

  1. في مدخل Azure أو Visual Studio، افتح تطبيقك المنطقي في Logic App Designer.

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

    Starting sample logic app for

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

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

      Select

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

  3. في مربع البحث، أدخل parse json كفلتر. من قائمة الإجراءات، حدد إجراء تحليل JSON .

    Select

  4. في مربع المحتوى ، قم بتوفير محتوى JSON الذي تريد تحليله.

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

    Select JSON object for parse JSON action

  5. أدخل مخطط JSON الذي يصف محتوى JSON الذي تقوم بتحليله.

    على سبيل المثال، إليك مخطط JSON:

    Provide JSON schema for the JSON object you want to parse

    إذا لم يكن لديك المخطط، فيمكنك إنشاء هذا المخطط من محتوى JSON، أو الحمولة، التي تقوم بتحليلها.

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

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

      Enter the JSON content for generating the schema

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

لمزيد من المعلومات حول هذا الإجراء في تعريف سير العمل الأساسي، راجع إجراء تحليل JSON.

اختبر تطبيق المنطق الخاص بك

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

  1. في تطبيق المنطق، أضف إجراء يمكنه إرسال النتائج من إجراء Parse JSON .

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

    يستخدم هذا المثال الإجراء Office 365 Outlook إرسال بريد إلكتروني ويتضمن حقول الاسم الأولواسم العائلةوالبريد الإلكتروني في نص البريد الإلكتروني:

    JSON properties in the

    فيما يلي إجراء البريد الإلكتروني النهائي:

    Finished example for email action

  3. الآن ، قم بتشغيل تطبيق المنطق يدويا. على شريط أدوات المصمم، حدد تشغيل.

    استنادا إلى موصل البريد الإلكتروني الذي استخدمته، إليك النتائج التي تحصل عليها:

    Email with

حدد الإجراء

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

ملاحظة

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

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

  1. في مدخل Azure أو Visual Studio، افتح تطبيقك المنطقي في Logic App Designer.

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

    Starting sample logic app for

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

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

      Select

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

  3. ضمن اختيار إجراء، حدد مضمن. في مربع البحث، أدخل select كفلتر. من قائمة الإجراءات، حدد الإجراء تحديد .

    Select the

  4. في المربع من ، حدد الصفيف المصدر الذي تريده.

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

    Select source array for Select action

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

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

    Specify JSON object property and values to create array

    فيما يلي الإجراء النهائي:

    Finished example for

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

لمزيد من المعلومات حول هذا الإجراء في تعريف سير العمل الأساسي، راجع تحديد الإجراء.

اختبر تطبيق المنطق الخاص بك

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

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

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

    @actionBody('Select')

    يستخدم هذا المثال الإجراء Office 365 Outlook إرسال بريد إلكتروني ويتضمن المخرجات من @actionBody('Select') التعبير في نص البريد الإلكتروني:

    Action outputs from

  3. الآن ، قم بتشغيل تطبيق المنطق يدويا. على شريط أدوات المصمم، حدد تشغيل.

    استنادا إلى موصل البريد الإلكتروني الذي استخدمته، إليك النتائج التي تحصل عليها:

    Email with

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

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

إذا تم إرجاع جدول 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"
			}
		}
	}
}

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