طلب HTTP في Power Automate - مقدمة

في هذا البرنامج التعليمي ، سنتعلم ونفهم كيف يعمل طلب HTTP في Power Automate عندما يتعلق الأمر بدمج تطبيقات الجهات الخارجية. سنتحدث أيضًا عن موصل الطلب المدمج ، لكننا سنناقش بشكل أساسي HTTP .

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

تسمح موصلات HTTP و Request لتدفقنا بالتفاعل مع واجهات برمجة تطبيقات تابعة لجهات خارجية.

لقد استخدمنا "الطلب" لتشغيل سير عمل في أحد برامجنا التعليمية السابقة. في هذا المثال ، كان لدينا تطبيق تابع لجهة خارجية أطلق تدفق Power Automate بالموافقات والمنطق الشرطي.

وهذه هي الطريقة التي يمكننا بها توصيل تطبيق جهة خارجية بتدفقاتنا. 

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

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

لكننا لا نريد الاحتفاظ بهذه المعلومات الحساسة داخل Power Automate . لذلك ، نحتاج إلى إنشاء واجهة برمجة تطبيقات في نظام الطرف الثالث لدينا والتي يمكنها استيعاب طلبات HTTP. وهذا ما سنفعله كمثال.

جدول المحتويات

• إعداد طلب HTTP في Power Automate
• عرض محتويات طلب HTTP في Power Automate
• تحليل JSON من طلبات HTTP
• خاتمة

إعداد طلب HTTP في Power Automate

ليس لدي حاليًا واجهة برمجة تطبيقات تابعة لجهة خارجية. لذلك في هذا المثال بالذات ، سنستخدم موقع ويب يسمى reqres.in . يحتوي على نقطة نهاية API لجهة خارجية يمكننا استخدامها لاختبار ما إذا كان التدفق الخاص بنا يعمل أم لا. على سبيل المثال ، لديهم وظيفة تسمى LIST USERS التي تحتوي على طلب مقابل. وإذا طلبنا ذلك ، فإن العناصر الموجودة في عمود الاستجابة هي كل ما يمكننا استعادته.

لذا ، لنجربها باستخدام موصل HTTP الخاص بنا. نحتاج أولاً إلى النقر فوق ارتباط الطلب .

ثم انسخ عنوان URL. هذا بمثابة نقطة نهاية API.

في إعداد التدفق الخاص بنا ، انقر فوق موصل HTTP .

ثم انقر فوق إجراء HTTP .

بالنسبة للطريقة ، انقر فوق GET .

ثم الصق عنوان URL الذي نسخته مسبقًا.

يمكننا أيضًا إدخال العناوين والاستعلامات وملفات تعريف الارتباط إذا أردنا ذلك. ومع ذلك ، سنتخطى ذلك الآن.

عرض محتويات طلب HTTP في Power Automate

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

ابحث وحدد موصل Slack .

انقر فوق إجراء نشر الرسالة .

دعنا ننشر المحتويات على القناة العشوائية .

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

دعنا نعيد تسمية التدفق إلى مثال HTTP .

ثم انقر فوق حفظ .

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

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

تحليل JSON من طلبات HTTP

أضف خطوة جديدة واختر موصل عملية البيانات .

ثم اختر تحليل JSON .

انقل خطوة تحليل JSON بين طلب HTTP وإجراء نشر الرسالة .

انقر فوق الزر "إنشاء من نموذج" . 

انسخ الرموز من رابط الطلب.

ثم قم بلصقه في نافذة Insert a sample JSON Payload وانقر فوق تم . سيؤدي هذا بشكل أساسي إلى إجراء تحليل JSON الخلفي لنا. 

كما لاحظنا ، فقد أنشأ تلقائيًا المخطط الذي يمكننا فهمه بسهولة.

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

ولماذا هذا مهم؟ حسنًا ، ليس علينا نشر نص الرسالة بالكامل بعد الآن. الآن ، لدينا إمكانية الوصول إلى المزيد من المحتويات الديناميكية مثل البريد الإلكتروني ، والاسم الأول ، واسم العائلة ، والصورة الرمزية ، والشركة ، وعنوان URL ، وغير ذلك الكثير.

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

الآن ، بدلاً من Body ، دعنا نغير هذا إلى first_name .

بعد ذلك ، سنرى أنه غير إجراءنا إلى "تطبيق على كل" .

هذا لأن التدفق الخاص بنا يتلقى عدة أسماء أولية من الطلب.

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

لنقم الآن بالنقر فوق حفظ ومعرفة ما إذا كان يعمل.

انقر فوق اختبار .

اختر سأقوم بتنفيذ إجراء المشغل وانقر فوق اختبار .

انقر فوق تشغيل التدفق .

كما نرى ، فإنه يعرض الأسماء الأولى فقط الآن.

خاتمة

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

يمكننا بالتأكيد القيام بالعديد من الأشياء المختلفة من خلال طلب HTTP وإجراءات تحليل JSON. نأمل أن تكون قادرًا على فهم أهميتها وكيفية عملها. 

أتمنى لك كل خير،

هنري

الموافقة على إعداد سير العمل والاختبار في الطاقة
أتمتة اعتماد Microsoft Flow بخيارات متعددة
شروط تشغيل التشغيل الآلي للطاقة - مقدمة