قم بإجراء طلب HTTP في Power Automate

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

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

• أتمتة الطاقة والموصلات
• عمل واستلام طلب HTTP
• تدفقات سطح المكتب
• كيف يعمل سير عمل طلب HTTP
• بدء التدفق في طلب HTTP
• تحليل ملف JASON
• باستخدام التطبيق على كل موصل
• تنفيذ سير العمل
• خاتمة

أتمتة الطاقة والموصلات

الموصل هو طريقة Power Automate للتواصل مع تطبيق آخر. يحتوي Power Automate بالفعل على آلاف الموصلات المتاحة لك. على سبيل المثال ، إذا كنت بحاجة إلى أتمتة شيء مرتبط بتطبيق Microsoft (Teams ، SharePoint ، OneDrive) أو التطبيقات الأخرى التي تحتوي على موصلات (Dropbox ، SAP) ، فيجب عليك دائمًا استخدام نهج الموصل ، وليس نهج طلب HTTP .

عمل واستلام طلب HTTP

إذا لم يكن هناك موصل له ، فيمكنك استخدام HTTP. يتم استخدام طلبات HTTP بواسطة Power Automate للتواصل مع تطبيق آخر لا يحتوي على موصل ولكن قد يحتوي على ما يسمى REST API .

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

تدفقات سطح المكتب

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

كيف يعمل سير عمل طلب HTTP

دعنا ندخل في سير عمل HTTP ونرى كيف يعمل. لديّ Power Automate مفتوحًا ، بالإضافة إلى البرنامج التعليمي الفعلي لواجهة برمجة تطبيقات REST.

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

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

لقد نقرت للتو على Make Pretty حتى نتمكن من رؤية كيف تبدو في الواقع.

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

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

بدء التدفق في طلب HTTP

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

أولاً ، أبدأ بإجراء مشغل يدوي للتدفق. لن يتم تشغيل هذا التدفق إلا عند النقر فوق زر ، ولكن يمكننا أيضًا تغييره بحيث يتكرر التدفق ويعمل كل صباح.

لدينا بعد ذلك موصل HTTP حيث ننفذ الطريقة. هناك طريقتان تنطبقان على واجهات برمجة التطبيقات: GET و POST . هناك أيضًا PATCH و DELETE ولكن نادرًا ما يتم استخدامهما.

إذا كنت ترغب في الحصول على معلومات من واجهة برمجة التطبيقات ، فعادة ما يتم ذلك إما من خلال GET أو POST . إذا كنت مهتمًا بمعرفة الفرق بين GET و POST ، فأنا أوصي حقًا بالبحث عبر الإنترنت عن RESTful APIs .

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

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

بمجرد تقديم هذا الطلب ، يمكننا إخراجه. لقد أنشأت محادثة مع براد بيت ، وهو مدير شركتي بعنوان Test لأننا نختبر ذلك للتو. ثم سنقوم بنشر النص (ناتج طلب HTTP هذا) في هذه المحادثة.

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

سيعيد هذا مجموعة من mumbo jumbo - إنه في الأساس ملف JSON غير قابل للقراءة حقًا. إنه لأمر رائع أن حصل براد بيت على ذلك ، لكنه لن يكون قادرًا على فهمه أو معرفة ما يعنيه.

تحليل ملف JASON

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

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

باستخدام التطبيق على كل موصل

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

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

في جزء الرسالة ، سنخرج الاسم الأول واسم العائلة والبريد الإلكتروني.

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

تنفيذ سير العمل

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

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

لدينا ستة عملاء وهذا يتوافق تمامًا مع ما لدينا في JSON.

ومن الواضح أننا تلقينا أيضًا رسالة JSON الفعلية الكاملة ، ولكن يصعب قراءتها.

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

مشغل HTTP لـ Microsoft Flow | إعداد واختبار سير عمل الموافقة على البرنامج التعليمي لأتمتة الطاقة في أتمتة الطاقة

خاتمة

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

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

إذا كنت قد استمتعت بالمحتوى المغطى في هذا البرنامج التعليمي المحدد ، فيرجى الاشتراك في قناة LuckyTemplates التلفزيونية. لدينا قدر هائل من المحتوى يصدر طوال الوقت مني ومن مجموعة من منشئي المحتوى ، وكلهم مكرسون لتحسين طريقة استخدامك لـ LuckyTemplates ومنصة Power.

هنري