نظرة عامة علي دورة حياة الموصل المخصص
قبل البدء فِي إنشاء موصلات مخصصة، تحتاج إلى معرفة جميع التفاصيل الخاصة بكل خطوة من الخطوات المتضمنة فِي دورة حياة الموصل المخصص. يوضح الرسم التخطيطي التالي جميع المهام المتضمنة فِي إنشاء واستخدام الموصلات المخصصة.
إنشاء وتأمين API الخاص بك
الموصل المخصص عبارة عن غلاف حول واجهة برمجة تطبيقات REST يسمح للخدمة الأساسية بالاتصال بـ Power Apps أو Power Automate أو Azure Logic Apps. تأكد من أن لديك API تعمل بكامل طاقتها قبل البدء فِي إنشاء موصلات مخصصة.
يمكنك استخدام أي لغة ونظام أساسي لواجهة برمجة التطبيقات الخاصة بك، طالما أنها متاحة كواجهة برمجة تطبيقات REST أو واجهة برمجة تطبيقات SOAP. فيما يلي بعض الأمثلة على ذلك:
واجهات API المتوفرة بشكر عام مثل NOAA، US Census API, or EU Open Data Portal.
واجهة API تقوم بإنشائها ونشرها إلى أي موفر استضافة مجموعة، مثل Azure أو Heroku أو Google Cloud.
API مخصص لخط الأعمال يتم نشرها على شبكتك. يمكنك الاتصال بـ API إذا كانت متوفرة عبر الإنترنت العام، أو يمكنك الاتصال بها من خلال بوابة (متوفرة حاليًا فِي Power Automate وPower Apps)
بالنسبة لتقنيات Microsoft، نوصي بإحدى الأنظمة الأساسية التالية:
لتامين API والموصلات الخاصة بك، يمكنك استخدام أحد أساليب المصادقة القياسية هذه (Azure Active Directory الموصى به):
OAuth 2.0 لخدمات معينة، مثل Microsoft Entra ID وDropbox وGitHub وSalesforce
يمكنك إعداد مصادقة Microsoft Entra ID لـ API لديك فِي مدخل Azure حتى لا تضطر إلى تنفيذ المصادقة من خلال التعليمات البرمجية. إذا لزم الأمر، يمكنك طلب وفرض المصادقة من خلال تعليمات API البرمجية. لمزيد من المعلومات حول Microsoft Entra ID للموصلات المخصصة، راجع تامين API والموصل باستخدام Azure AD.
وصف API وتعريف الموصل المخصص
بعد أن يكون لديك API، فإن الخطوة التالية التي يجب مراعاتها هي كيفية وصف واجهة API وعملياتها حتى تتمكن تطبيقات Power Apps وPower Automate وAzure Logic Apps من الاتصال بـ API. بعد تحديد كيفية وصف API، يمكنك إنشاء الموصل، الذي يقوم بتسجيله بعد ذلك مع الخدمات المناسبة.
استخدم أحد الأساليب التالية لوصف API:
تعريف OpenAPI (المعروف سابقاً باسم ملف Swagger). لمزيد من المعلومات، راجع إنشاء موصل مخصص من OpenAPI وما هو Swagger.
يمكنك أيضًا البدء باتصال مخصص فارغ باستخدام معالج الموصل المخصص فِي Power Apps وPower Automate. لمزيد من المعلومات، راجع إنشاء موصل مخصص من البداية للحصول علي معلومات إضافية.
تستخدم تعريفات OpenAPI تنسيقاً مختلفاً، لكن يعدان مستندات مستقلة لغوياً وقابلة للقراءة آلياً تصف عمليات ومعلمات API لديك. يمكنك إنشاء هذه المستندات من أدوات مختلفة، بناءً على اللغة والنظام الأساسي الذي يستخدمه API. خلف الكواليس، تطبيقات Power Apps وPower Automate وAzure Logic Apps تستخدم OpenAPI لتحديد الموصلات.
استخدام موصل مخصص
يمكنك استخدام الموصل المخصص بنفس الطريقة التي تستخدم بها الموصلات المضمنة. يمكنك إنشاء الاتصال بـ API واستدعاء أية عمليات متوفرة من خلال API بنفس الطريقة التي يتم بها استدعاء العمليات للموصلات المضمنة.
يمكن استخدام الموصلات التي تم إنشاؤها فِي Power Apps أو Power Automate فِي كلتا الخدمتين، ولكن لا يمكن استخدام الموصلات التي تم إنشاؤها فِي Azure Logic Apps مباشرة فِي الخدمات الأخرى. ومع ذلك، يمكن إعادة إنشاء موصل بسهولة باستخدام نفس تعريف OpenAPI المستخدمة لإنشاء موصل Azure Logic Apps.
لمزيد من المعلومات حول استخدام الموصلات المخصصة من Power Apps وPower Automate وAzure Logic Apps:
شارك الموصل المخصص
يمكن مشاركة الموصلات مع مستخدمين آخرين فِي مؤسستك بنفس الطريقة التي تشارك بها الموارد فِي Power Apps وPower Automate وAzure Logic Apps. لمزيد من المعلومات، راجع مشاركة موصل مخصص فِي مؤسستك.
اعتماد موصل مخصص
إذا كنت ترغب فِي مشاركة الموصل مع جميع المستخدمين فِي Power AppsوPower Automate وAzure Logic Apps، فيمكنك إرسال الموصل للحصول على شهادة Microsoft. أثناء هذه العملية، تقوم Microsoft بمراجعة الموصل والتحقق من التوافق التقني والمحتوى والتحقق من صحة وظائف Power Apps وPower Automate وAzure Logic Apps. لمزيد من المعلومات، راجع إرسال الموصل لشهادة Microsoft.