إشعار
يتطلب الوصول إلى هذه الصفحة تخويلاً. يمكنك محاولة تسجيل الدخول أو تغيير الدلائل.
يتطلب الوصول إلى هذه الصفحة تخويلاً. يمكنك محاولة تغيير الدلائل.
في Copilot Studio، يمكنك توسيع قدرات العامل عن طريق استدعاء واجهات برمجة تطبيقات REST الخارجية باستخدام عقدة HTTP Request. يمكن أن يكون هذا الاستدعاء مفيدا عندما تحتاج إلى استرداد البيانات من نظام خارجي أو معالجة البيانات على هذا النظام.
المتطلبات المسبقه
استخدام عقدة طلب HTTP
حدد أيقونة إضافة عقدة
ضمن العقدة التي تريد بعدها استدعاء واجهة برمجة تطبيقات خارجية، وأشر إلى خيارات متقدمة، وحدد إرسال طلب HTTP.في مربع URL ، أدخل عنوان URL لنقطة نهاية واجهة برمجة التطبيقات التي تريد الاتصال بها.
حدد أسلوب الطلب المناسب من القائمة المنسدلة. يتم دعم أساليب GET وPOST و PATCH و PUT و DELETE.
ضمن الْرؤوس والْمحتوى فِي الْعقدة، حدد الْزر تحرير، الْذي يفتح لوحة خصائص طلب HTTP.
يمكنك اختياريا إضافة رأس واحد أو أكثر إلى طلب HTTP. حدد الزر Add لإضافة مفتاح وقيمة العنوان لكل عنصر.
يمكنك استخدام قسم الرؤوس لتمرير رموز المصادقة أو نوع المحتوى أو أي عناوين مطلوبة أخرى لواجهة برمجة التطبيقات المستهدفة. على سبيل المثال، يمكنك إضافة عنوان مثل
Authorization: Bearer <your_token>لمصادقة الطلب.بشكل افتراضي، لا يتم إرسال أي محتوى في نص طلب HTTP، ولكن يمكنك تحديد محتوى في النص الأساسي.
على العقدة، اختر نوع بيانات الاستجابة من الخيارات المتوفرة.
يمكنك تقديم مثال استجابة JSON، والتي يمكنك عادة العثور عليها في وثائق واجهة برمجة التطبيقات التي تتصل بها. يقوم بإنشاء متغير Power Fx، مما يسمح لك باستخدامه في مكان آخر في لوحة التأليف الخاصة بك، مع دعم intellisense في محرر Power Fx. حدد من بيانات العينة ثم حدد احصل على المخطط من JSON العينة. الصق نموذج الاستجابة في المحرر وحدد Confirm.
ضمن حفظ استجابة المستخدم كاختر المكان الذي تريد تخزين استجابة طلب HTTP فيه، إما إنشاء متغير جديد أو تحديد متغير موجود.
إرسال المحتوى في نص طلب HTTP
ضمن الْرؤوس والْمحتوى فِي الْعقدة، حدد الْزر تحرير، الْذي يفتح لوحة خصائص طلب HTTP.
ضمن النص الأساسي، حدد نوع المحتوى المناسب. بشكل افتراضي، يتم تعيين النص الأساسي إلى بلا محتوى، حيث لا يجب أن يكون أي محتوى موجودا داخل نص الطلب، وهو الأكثر استخداما مع طلب GET. لإضافة محتوى إلى النص الأساسي، حدد من أحد الخيارات المتوفرة.
محتوى JSON: يسمح لك محتوى JSON بتوفير كائن JSON في نص الطلب. غالبا ما يتم استخدام هذا الكائن عند إجراء طلبات POST أو PUT. عند تحديد هذا الخيار، يسمح لك المحرر بإدخال محتوى JSON الخاص بك.
يمكنك أيضا تحديد محتوى JSON الخاص بك باستخدام Power Fx، ما يسمح لك بتضمين قيم ديناميكية ومتغيرات مرجعية. حدد الزر تحرير JSON ، واختر صيغة، ثم أدخل كائن Power Fx (يتم تحويل أي JSON موجود تم إدخاله إلى كائن Power Fx لك)، والذي يتم تحويله إلى JSON عند إجراء طلب HTTP.
المحتوى الخام: يتيح لك المحتوى الخام إدراج سلسلة من البيانات في نص الطلب، ويمكن أن تكون هذه السلسلة من أي نوع محتوى تحدده. يتم إدخال المحتوى الخام باستخدام صيغة Power Fx، مثل محتوى السلسلة الموضح في المثال التالي.
معالجة الأخطاء والوقت المستغرق
تحتوي عقدة طلب HTTP على خيارات متعددة لمعالجة المواقف التي قد يفشل فيها طلب HTTP أو يرجع خطأ.
بشكل افتراضي، تظهر الميزة خطأ. وهذا يعني أنه عندما يقوم طلب HTTP بإرجاع خطأ أو فشل في التنفيذ، يوقف العامل تشغيله ويشغل موضوع نظام عند الخطأ ، ويعرض رسالة خطأ.
ومع ذلك، يمكنك تكوين معالجة الأخطاء لعدم تشغيل موضوع نظام عند الخطأ . بدلا من ذلك، يمكنك جعله يخزن رمز حالة HTTP وأي نص استجابة خطأ في متغيرات تحددها. يمكنك استجواب هذه المتغيرات حسب الحاجة، ويمكن أن يستمر تشغيل الموضوع. هذا التكوين مفيد في السيناريوهات التي تريد من العامل فيها متابعة العملية، حتى إذا فشل طلب HTTP معين.
لتكوين سلوك معالجة الأخطاء لعقدة طلب HTTP :
ضمن الرؤوس والنص الأساسي، حدد تحرير. تظهر لوحة خصائص طلب HTTP .
ضمن معالجة الأخطاء، حدد السلوك المطلوب: رفع خطأ، أو متابعة عند الخطأ.
إذا حددت متابعة عند الْخطأ، فكون الْمتغيرات لرمز الْحالْة والْنص الْأساسي للاستجابة للخطأ.
في هذا المثال، إذا فشل طلب HTTP، يخزن العامل رمز حالة HTTP في Topic.StatusCode المتغير، و نص الاستجابة Topic.ErrorResponse في المتغير. يستمر العامل في خطواته التالية في الموضوع.
نوع متغير استجابة الخطأ هو Any. يمكنك استخدام عقدة قيمة تحليل لتحويل هذا المتغير إلى سجل Power Fx.
في لوحة خصائص طلب HTTP ، يمكنك أيضا تعيين خاصية مهلة الطلب ، بالمللي ثانية. القيمة الافتراضية هي 30 ثانية.