مقدمة
تقوم هذه الوحدة النمطية باستكشاف استخدام السياسات مع الموصلات المخصصة ويشرح كيفية تكوينها باستخدام قوالب السياسات.
خلال هذه الوحدة النمطية، سوف تتمكن مما يلي:
استكشاف كيف يمكن للسياسات تعديل سلوك الموصلات المخصصة في وقت التشغيل.
تطبيق قوالب السياسة على موصل مخصص.
تسمح لك السياسات بتعديل سلوك الموصل المخصص في وقت التشغيل. يمكنك استخدام السياسات لإجراء تحويل البيانات وتوجيه الطلبات وتعيين قيم المعلمات والمزيد. يمكنك تكوين السياسات مباشرة في ملف خصائص API للموصل المخصص قبل الاستيراد، أو يمكنك القيام بذلك مِن maker portal في مصمم الموصل المخصص عن طريق تطبيق قوالب السياسة.
حالات استخدام السياسة الشائعة هي:
تعيين URL الخاص بالمضيف - بشكل افتراضي، يتم تعيين قيمة لا يمكن تغييرها لعنوان URL للمضيف في تكوين الموصل. تسمح السياسة، المدمجة مع معلمات الاتصال، بتحديد عنوان URL للمضيف في كل مرة يتم فيها إنشاء اتصال باستخدام الموصل. على سبيل المثال، قد تعالج حالة الاستخدام هذه إصدار المنتج والاختبار والإنتاج لواجهة API الخاصة بالنظام.
تعيين الرأس - الاستخدام لترقية البيانات مِن معلمات الاتصال أو الاستعلام أو نص الطلب إلى الرأس. وبشكل عام، يتم إجراء هذه العملية لاستيعاب واجهات API التي تريد تكوين معلومات معينة في الرأس. على سبيل المثال، قد تكون حالة الاستخدام هذه عبارة عن معرف ارتباط لتعقب العملية التجارية الكاملة التي يتم القيام بها.
تعيين معلمة الاستعلام - استخدام لمعالجة القيم الافتراضية، إذا لزم الأمر، ولكن لم تقم الأداة بتكوين أحدها. على سبيل المثال، إذا كانت واجهة API تتطلب معلمة عليا لعدد السجلات التي يتم إرجاعها باستخدام سياسة، يمكنك تعيين قيمة افتراضية ليتم استخدامها في حالة عدم قيام المنشئ بتكوين أحدها.
يمكنك استخدام السياسات لمعالجة احتياجات API المحددة وجعل الموصل أسهل في الاستخدام بواسطة إخفاء التعقيدات غير الضرورية.
تطبيق سياسة
يسمح تطبيق قالب سياسة على موصل مخصص بتحديد السياسة التي ترغب في استخدامها مِن قائمة قوالب. سيطالبك كل قالب محدّد بملء التكوين الضروري لتلك السياسة. عند إكمال النموذج، يتم تنشيط السياسة بعد تحديث الموصل. تعرض اللقطة التالية مثالاً لإنشاء سياسة جديدة باستخدام أحد القوالب.
عندما تقوم بتطبيق قالب سياسة، يمكنك اختيار أن يتم تطبيقه على كافة الإجراءات والمشغّلات أو الخاصة ببعضها البعض فقط.
على سبيل المثال، قالب تعيين عنوان URL الخاص بالمضيف عادة ما يتم تطبيقه على كافة الإجراءات والمشغّلات. على العكس، قد يتم تطبيق القالب تحويل صفيف إلى كائن (الإصدار الأولي) فقط على إجراء واحد أو إجراءين يرجع بيانات متشابهة.
عند تكوين سياسة لتنفيذها على كافة الإجراءات والمشغّلات، يجب التأكد مِن أن أية مسارات بيانات مستخدمة في معلمات السياسة صالحة لكافة الإجراءات والمشغّلات؛ وإلا، ستواجه أخطاء أثناء وقت التشغيل.
في قائمة النهج التي تم تكوينها، يمكنك تحديد علامة القطع (...) بجوار كل سياسة وتحريكها إلى أعلى أو أسفل القائمة. تسمح لك هذه الميزة بتكوين الترتيب الذي يتم تطبيق السياسة به في وقت التشغيل، والذي يمكن أن يكون مفيداً في وحدات السيناريو التي تستخدم فيها قوالب سياسة متعددة لإنجاز تحويل البيانات. على سبيل المثال، يمكن لإحدى السياسات تحليل سلسلة محددة إلى صفيف، ويمكن لنهج آخر تحويل الصفيف إلى كائن. في هذا المثال، قد يكون ترتيب التطبيق هاماً.
يؤدي تكوين قالب سياسة إلى تعديل خصائص واجهه API للموصل. يتم تخزين خصائص API بشكل منفصل عن تعريف API للموصل. يمكنك استيراد تعريف API محدث مِن خلال المدخل دون الكتابة فوق السياسة التي قمت بتكوينها.
العرض والتعديل باستخدام CLI
بالإضافة إلى عرض السياسة في المدخل، يمكنك تصديرها كجزء مِن ملف خصائص API باستخدام أمر تنزيل paconn مِن CLI.
يتضمن التنزيل أربعة ملفات (apiDefintion.swagger.json, apiProperties.json, icon.png, settings.json).
إذا قمت بفتح الملف apiProperties.json وتحديد موقع القسم policyTemplateInstances، ستشاهد جميع السياسات التي تم تكوينها.
تُظهر لقطة الشاشة التالية مثالاً على قسم policyTemplateInstances.
يمكنك أيضا تعديل الملف apiProperties.json مباشرة إذا كنت على دراية بالعمل في JSON. مع بعض السياسات، مثل تعيين URL الخاص بالمضيف، إذا كنت تريد المطالبة بعنوان URL عند إنشاء اتصال، سيلزم تعديل connectionParameters في ملف apiPropertiess.json لإكمال تكوين السياسة. يمكن استخدام الأمر تحديث paconn لاستيراد التغييرات.
وقد يكون مِن المفيد مراعاة كيفية استخدام الموصلات الأخرى للسياسة. يحتوي مستودع GitHub موصلات Microsoft Power Platform على العديد مِن الأمثلة الرائعة عن الموصلات المعتمدة وغير المعتمدة التي يمكنك مراجعتها. بالإضافة إلى ذلك، يمكنك الاستعراض والنظر إلى ملف apiProperties.json للموصلات. يمكن أيضا للبحث عن المستودع باستخدام اسم قالب السياسة، مثل setHeader، الكشف السريع عن الموصلات التي تستخدم هذه السياسة.