اعتماد موصل مخصص
لجعل موصل مخصص متوفراً لجميع المستخدمين في Azure Logic Apps، وPower Automate وPower Apps وكموصل مرخص، أرسل الموصل الخاص بك إلى Microsoft للحصول على شهادة. ستُراجع Microsoft الموصل، وإذا كان يفي بمعايير الشهادة، فستوافق على نشره. وبعد نشر الموصل، سينضم إلى القائمة الكاملة للموصلات المتوفرة بشكل عام.
تعمل هذه الوحدة على فحص كل خطوة، بما في ذلك بعض الخطوات عالية المستوى، في عملية الشهادة. تنطبق هذه الخطوات نفسها على تحديثات لاحقة أيضًا، ولكن حسب نطاق التحديث، يمكن أن تكون أسرع على نحو ملحوظ.
التخطيط
التخطيط هو الخطوة الأولى في عملية الشهادة عند بدء تصور المظهر الذي سيبدو عليه الموصل لديك. يجب أن يتضمن بناء موصل سيستخدمه آخرون بعض التخطيط.
تتمثل الخطوة الأولى في التحقق من عدم وجود موصل بالفعل، وإذا كان موجودًا، فيجب أن تفكر في المساهمة في الموصل الحالي بتغييراتك المقترحة لأن Microsoft لن تصادق على موصلات متعددة لنفس واجهة برمجة التطبيقات.
توجد بعض عوامل التخطيط الأساسية التي عليك وضعها في الاعتبار وهي:
تحديد المشغلات والإجراءات التي ستتوفر في البداية. لا تحتاج إلى تغطية 100 بالمائة من API، ولكن يجب أن تكون مجموعة المشغلات والإجراءات الأولية مجموعة مفيدة. إذا كنت مقيِّدًا للغاية فيما لديك في إصدارك الأول، فسيُصاب المستخدمون بالإحباط من افتقاد هذه الوظيفة للسيناريوهات الشائعة. ضع في اعتبارك كتابة أو تخطيط مهمة سير عمل أو أكثر يمكن إنشاؤها في Microsoft Power Automate باستخدام الموصل الخاص بك. يمكن أن يساعدك هذا الأسلوب في تحديد واجهات API التي يجب تضمينها في الموصل.
قم بتقييم التغييرات التي قد تلزم لواجهة API لدعم المشغلات أو تحسين قدرة توصيل موصل مألوف للمستخدم.
خذ بعين الاعتبار الطريقة التي ستتم بها معالجة المصادقة والملاءمة الضرورية بين كيف تُجري واجهة API المصادقة لديك حاليًا والقدرات المدعومة للموصلات المخصصة.
خذ بعين الاعتبار كيف سيحصل المستخدمون الذين يريدون استخدام الموصل على مفتاح، إذا كانت واجهة API تستخدم مفاتيح API.
راجع قوالب سياسة الموصل لتحديد ما إذا كان تنفيذ القوالب سيساعد في قابلية استخدام الموصل الخاص بك.
راجع ملحقات OpenAPI المدعومة لمعرفة مدى قابليتها للتطبيق. على سبيل المثال، يتم تنفيذ اتصال الاختبار عادة بواسطة موصلات معتمدة. وأيضاً، يمكن لاستخدام ملحقات قيم ديناميكية أن يفيد إذا كانت لديك معلمات لها قوائم قيم يمكنك الاختيار من بينها.
بالنسبة لشهادة الموصل الجديدة، ليس عليك الانتظار حتى تنتهي من تطوير الموصل للتسجيل من أجل الشهادة. لمزيد من المعلومات، راجع عملية اعتماد الناشر المعتمد أو عملية اعتماد الناشرين المستقلين. توقَّع تلقي عملية تواصل من أحد ممثلي Microsoft، والذي سيساعدك على فهم الموصل المخصص الخاص بك على نحو أفضل، ويوضِّح سير عملية التطوير، ويرشدك خلال عملية الشهادة.
بالنسبة للتحديثات إلى موصل معتمد، فالجزء الأهم من التخطيط هو عدم تقسيم المستخدمين الموجودين. ستتم مناقشة هذه المشكلة بمزيد من التفصيل في الوحدة اللاحقة.
التطوير
ينصب الاهتمام الرئيسي في خطوة التطوير على تجهيز API الخاصة بك وتعريف الموصل المخصص الخاص بك للتسليم. قبل المتابعة إلى الخطوة التالية، يجب التأكد من تنظيف تعريف الموصل المخصص لديك ومن أنه يحمل التسمية المناسبة التي تريد نشرها.
إنشاء مصدر مفتوح
لقد تناولت وحدة المقدمة نظرة عامة عالية المستوى حول كيفية إنشاء موصل مصدر مفتوح. ستضع الموصل المعتمد للناشر المعتمد في مجلد الموصلات المعتمدة وموصلات الناشر المستقلة في مجلد موصلات الناشر المستقلة. وقبل إرسال طلب سحب، تأكد من اجراء المهام التالية:
حرر ملفات الموصل الخاصة بك لإضافة بيانات التعريف المطلوبة المحددة. يجب أن تحتوي ملفات الموصل الخاصة بك عَلى بيانات تعريف معينة تصف الموصل وخدمة النهاية الخاصة به.
قم بتشغيل أمر paconn validate على الموصل الذي قمتَ بتنزيله، ثم قم بحل الأخطاء.
لتشغيل التحقق من الصحة، استخدم الأمر التالي:
paconn validate --api-def [Location of apiDefinition.swagger.json]
وبعد اجتيازك التحقق من الصحة، يمكنك إرسال طلب السحب إلى فرع dev الخاص بمستودع GitHub. سيؤدي هذا الإجراء إلى بدء عملية تلقائية ستُجري تحققًا مبدئيًا من صحة طلب السحب، وتتأكد من أنه لديك اتفاقيه مساهمة مناسبة سارية. عند اكتمال التحقق من الصحة التلقائي، سيتم تعيينه إلى Microsoft لإجراء مراجعة أولية عليه. إذا وجد المراجعون مشكلات تحتاج إلى التصحيح، فسيُدخلون تعليقات على طلب السحب، وسيُتوقع أن تقوم بحلها ثم إعادة إرسال طلب السحب. وعندما يبدو كل شيء مقبولاً، سيتم دمج طلب السحب الخاص بك إلى المستودع.
تقديم الناشر المستقل
إذا كنت تنشر موصل ناشر مستقل، فإن خطوتك التالية هي إرسال عناصر الموصل إلى طلب السحب الذي أنشأته عندما اقترحت الموصل، واملأ قائمة التحقق في نموذج طلب السحب، وأزل "اقتراح -" من عنوان طلب السحب. سيقدم مهندس معتمد لدى Microsoft ملاحظات في غضون أسبوع إلى أسبوعين من طلبك الأولي. إذا كانت الملاحظات تتطلب تحديثًا للموصل، فستحتاج إلى إرسال تحديث لطلب السحب. بمجرد
تم التحقق من تقديم الناشر
والخطوة التالية هي إرسال الموصل الخاص بك للاعتماد في ISV Studio بعدما تطلب منك جهة اتصال Microsoft التي تتبعها القيام بذلك. يعد ISV Studio مدخلاً لإدارة بقية عملية الشهادة، وسيوفر لك سلامة الموصل الخاص بك بعد نشره.
كجزء من عملية الإرسال إلى ISV Studio للاعتماد، يجب أن تكون على استعداد لتوفير ما يلي:
معلومات حول اختبار الموصل، على سبيل المثال، أحد مفاتيح API، أو تفاصيل المصادقة الأخرى، أو أي تفاصيل قد تساعد المختبر على استخدام الموصل.
ملف
Intro.mdيحتوي على معلومات لتضمينها في الوثائق العامة للموصل. يمكنك العثور على نموذج في وثائق التقديم إلى ISV Studio.
وبمجرد تقدم عملية الشهادة، ستحصل على التحديثات في المدخل، وستتلقى رسالة بريد إلكتروني من جهة الاتصال الرئيسية. إذا تمت مواجهة مشكلات، فسيُتوقع منك حلها قبل متابعه عملية الاعتماد. وبعد اجتياز الموصل عملية الاعتماد، ستتم جدولته للتوزيع في منطقه "المعاينة" لاختباره.
الاختبار
كجزء مِن عملية الاعتماد، يتم توزيع الموصل الخاص بك إلى منطقة "المعاينة" لاختباره. وتحين الآن فرصتك فِي التأكد مِن أن الموصل الذي تم توزيعه يعمل بشكل صحيح قبل توزيعه عَلى جميع المناطق حول العالم. تأكد مِن اختبار جميع وظائف الموصل الخاص بك فِي Power Apps وPower Automate و"التطبيقات المنطقية".
لمزيد من المعلومات، راجع إرشادات حول اختبار الموصل الخاص بك في الشهادة.
التوزيع
بعد اكتمال الاختبار، سيتم توزيع الموصل الخاص بك على جميع المناطق العامة. ويُتوقَّع أن تأخذ هذه العملية من سبعة إلى 10 أيام عمل لأن Microsoft توزِّع على نحو تزايدي في مناطقها حول العالم. وستتلقى إعلامات عند نشر كل منطقة.
الدعم
الآن، وقد تم إصدار الموصل الخاص بك بشكل عام، بالنسبة إلى موصلات الناشر التي تم التحقق منها، يمكنك مراقبة أدائه من ISV Studio. تأكد من أن موظفي الدعم يدركون كيفية استخدام الموصل الخاص بك مع Power Apps أو Power Automate حتى يمكنهم اعتماد المستخدمين الذين يواجهون مشكلات.