تنفيذ إجراء

  • 5 دقائق

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

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

أنواع الإجراءات

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

الوصول إلى الخدمات الخارجية

الإجراءات التي تتيح لك استخدام خدمات خارج تطبيقك المنطقي هي النوع الأكثر شيوعًا إلى حد بعيد. في الواقع، هذه الإجراءات شائعة جدًا، لدرجة أنها تعني ما يقصده معظم الناس عند استخدامهم لمصطلح إجراء. إنها تتيح لك الوصول إلى مئات المنتجات، مثل Salesforce وOracle وYouTube وDropbox وGmail وGitHub وTwilio وFacebook وSlack وJira. يبيّن الرسم التوضيحي التالي بعض الإجراءات الخارجية المتاحة.

An illustration showing several common external actions. The actions are divided into groups. For example, there is a grouping for database actions, which shows Oracle, SQL Server, and Azure Cosmos DB.

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

على سبيل المثال، للاتصال بـ Cognitive Services، فإنك تعطي Site URL حتى يعرف تطبيقك المنطقي مكان إرسال الطلب وAccount Key لإثبات أنك مخول للوصول إلى الخدمة. تتوفر هاتان القيمتان في حساب Cognitive Services الخاص بك. ستقوم عادةً بنسخها في إعدادات إجراء Detect-sentiment.

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

معالجة البيانات

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

لنلقِ نظرة على مثال. إذا استخدمت Twitter لفترة من الوقت، فقد تكون على دراية بنمط عنوان URL الخاص به للربط بتغريدة معينة:

https://twitter.com/[username]/status/[id]

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

البيانات التي تحصل عليها من مشغل Twitter لا تتضمن عنوان URL الكامل هذا. ومع ذلك، فإنه يحتوي على اسم المستخدم في حقل twitterBy والمعرّف في حقل TweetId. يمكنك استخدام العملية البيانية Compose للجمع بينها في عنوان URL. ومن الناحية المفاهيمية، ستكون العملية كما يلي:

Compose: "https://twitter.com/" + [TweetedBy] + "/status/" + [TweetId]

تعديل تدفق التحكم

تتيح لك ميزة control action في Logic Apps إضافة عناصر تحكم مثل العبارات والتكرارات الحلقية الشرطية إلى تطبيقك. سيستخدم تطبيق مراقبة وسائل التواصل الاجتماعي إجراءً تحكمياً للتفرع بناءً على ما إذا كانت توجّهات التغريد إيجابية أم سلبية. سنرى كيف يعمل هذا ونناقش جميع إجراءات التحكم لاحقًا في هذه الوحدة.

معلمات الإجراء وقيم الإرجاع

يمكنك اعتبار الإجراءات استدعاءات دالة لها معلمات وقيم إرجاع.

تتيح لك معلمات الإجراء تمرير القيم إلى العملية. يحتوي إجراء Detect-sentiment في Cognitive Services على معلمة تسمى Text تمثل السلسلة التي تريد تحليلها. يحتوي أيضًا على معلمة اختيارية تسمى Language تتيح لك تقديم تلميح حول لغة النص.

القيم المرجعة للإجراء هي نتائج العملية. يُرجع إجراء Detect sentiment درجة رقمية بين 0 و1. تشير الدرجات القريبة من 1 إلى توجه إيجابي، بينما تشير الدرجات القريبة من 0 إلى توجه سلبي. يلخص الرسم التوضيحي التالي تدفق البيانات لإجراء Detect sentiment كما هو مستخدم بواسطة تطبيق مراقبة مواقع التواصل الاجتماعي.

An illustration showing a logic app using the **Detect sentiment** action to invoke the Text Analytics service. The app passes the tweet text to the service and gets back a numeric sentiment score..

المعلمات الثابتة مقابل المعلمات الديناميكية

ستكون بعض المعلمات التي ترسلها إلى إجراء ما هي نفسها في كل مرة. على سبيل المثال، قد تكون مهتمًا فقط بالتغريدات المكتوبة باللغة الإنجليزية؛ لذا يمكنك دائمًا تمرير «en» كمعامل Language إلى إجراء Detect sentiment. لا يوجد شيء صعب بشأن هذا النوع من المعلمات الثابتة. تقوم بتدوين القيمة عند تكوين الإجراء ويتم استخدام هذه القيمة في كل مرة يتم فيها تشغيل الإجراء.

ستكون المعلمات الأخرى مختلفة في كل مرة تقوم فيها بتنفيذ إجراء ما. تعد معلمة Text في إجراء Detect sentiment مثالاً جيدًا على ذلك. عندما تمرر نص التغريدة، سيكون الأمر مختلفًا في كل مرة. كيف تحصل على هذه القيمة الديناميكية؟

تذكر أن التغريدة التي نعالجها كانت هي القيمة المرجعة للخطأ When a new tweet is posted. يتم تجميع بيانات التغريدة هذه داخل عنصر مع عدة حقول تحتوي على تفاصيل التغريدة. يجعل Logic Apps هذا العنصر متاحًا تلقائيًا في بقية التطبيق. يمنحك Logic Apps Designer واجهة مستخدم رسومية بسيطة لتحديد الحقول التي ترغب فيها.

إضافة وتكوين إجراء باستخدام المصمم

يمنحك Logic Apps Designer واجهة مستخدم رسومية لإضافة الإجراءات وتكوينها. يمكنك إضافة إجراءات جديدة إلى نهاية تطبيقك أو إدراج إجراء بين الخطوات الموجودة.

تتمثل الخطوة الأولى في تحديد خيار Add an action عند النقطة في تطبيقك حيث تريد أن يظهر الإجراء الجديد. يؤدي هذا إلى تشغيل واجهة المستخدم «اختيار إجراء». توضح لقطة الشاشة التالية كيفية إضافة إجراء جديد باستخدام Logic Apps Designer.

A screenshot showing the Logic Apps Designer GUI to choose an action to add to your app. The user can select an action from a list or use a search feature to locate the one they need.

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

A screenshot showing the Logic Apps Designer GUI for dynamic content. The example shows tweet data such as **Created at**, **Description**, and **Location** displayed in a list. The user can select an item from the list to include it in their app.

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