إنشاء موصل مخصص لواجهة برمجة التطبيقات (API) الحالية

  • 20 دقائق

في هذا التمرين، ستقوم بإنشاء أول موصل مخصص لواجهة API موجودة يطلق عليها اسم Contoso Invoicing.

هام

استخدم بيئة اختبار مع توفير Microsoft Dataverse. وإذا لم تتوفر لديك بيئة اختبار، فيمكنك الاشتراك في خطة مجتمع Power Apps.

المهمة: مراجعة واجهة برمجة التطبيقات (API)

لمراجعة API، اتبع الخطوات التالية:

  1. انتقل إلى Contoso Invoicing.

  2. حدد ارتباط الوثائق.

    لقطة شاشة لسهم يشير إلى ارتباط وثائق API.

  3. راجع العمليات المتاحة.

  4. حدد هذا لتوسيع كل عملية ومراجعتها.

  5. أغلق نافذة أو علامة تبويب مستعرض الوثائق.

  6. حدد ارتباط تعريف Open API.

  7. تعرض الصورة التالية مثالاً لإصدار OpenAPI لما تم إظهاره في صفحة الوثائق. انقر بزر الماوس الأيمن وحدد حفظ باسم.

    لقطة شاشة لسهم يشير إلى زر الحفظ باسم.

  8. حفظ الملف محلياً. ستستخدم هذا الملف في وقت لاحق في هذا التمرين:

  9. أغلق نافذة أو علامة تبويب مستعرض التعريف.

  10. حدد ارتباط مفتاح API.

  11. قم بنسخ مفتاح API وحفظه لأنك ستحتاجه في وقت لاحق.

    لقطة شاشة لمفتاح API لـ Contoso invoicing.

  12. حدد رجوع إلى الصفحة الرئيسية.

  13. حدد تنزيل الشعار.

  14. احفظ صورة الشعار محلياً؛ ستستخدمه في وقت لاحق.

المهمة: إنشاء حل جديد

لإنشاء حل جديد، اتبع هذه الخطوات:

  1. انتقل إلى Power Apps maker portal وتأكد من وجودك في البيئة الصحيحة.

  2. حدد الحلول > + حل جديد.

  3. أدخل Contoso invoicing لـ اسم العرض وبعد ذلك، حدد الزر + ناشر جديد.

    لقطة شاشة توضح زر إضافة ناشر جديد.

  4. أدخل Contoso للحصول على اسم العرض، Contoso للاسم، contoso للبادئة، ثم حدد حفظ.

  5. حدد Contoso لـ الناشر، ثم حدد إنشاء. عند العمل باستخدام مشروع حقيقي، فمن الأفضل إنشاء ناشر خاص بك.

    لقطة شاشة لتفاصيل حل Contoso Invoicing الجديد.

  6. لا تخرج من هذه الصفحة بعد تحديد إنشاء.

المهمة: إنشاء موصل جديد

لإنشاء موصل جديد، اتبع هذه الخطوات:

  1. افتح حل Contoso Invoicing الذي قمت بإنشائه.

  2. حدد + جديد > تنفيذ تلقائي > موصل مخصص.

    لقطة شاشة لسهم يشير إلى إنشاء موصل مخصص جديد.

  3. أدخل Contoso invoicing لـ اسم الموصل، ثم حدد لـ تحميل.

    لقطة شاشة تُظهر سهماً يشير إلى زر صورة أيقونة التحميل.

  4. حدد صورة شعار الموصل التي قمت بتنزيلها في المهمة 1: مراجعة واجهة برمجة التطبيقات (API).

  5. أدخل #175497 لـ لون خلفية الأيقونة.

  6. أدخل الموصل المخصص لـ Contoso Invoicing API لـ الوصف.

  7. أدخل contosoinvoicingtest.azurewebsites.net لـ المضيف.

  8. حدد إنشاء موصل.

    لقطة شاشة لزر إنشاء موصل مخصص.

  9. لا تخرج من هذه الصفحة.

المهمة: استيراد تعريف OpenAPI

لاستيراد تعريف OpenAPI، اتبع الخطوات التالية:

  1. حدد السهم بجوار اسم الموصل.

    لقطة شاشة لسهم يشير إلى زر الرجوع.

  2. حدد زر علامة الحذف (...) للموصل، ثم حدد تحديث من ملف OpenAPI.

    لقطة شاشة لسهم يشير إلى زر التحديث من ملف API المفتوح.

  3. حدد استيراد.

  4. حدد الملف swagger.json الذي قمت بتنزيله في الهامة 1: مراجعة واجهة برمجة التطبيقات (API) ثم حدد Open.

  5. حدد متابعة.

  6. قم بملء عنوان URL للمضيف كـ contosoinvoicingtest.azurewebsites.net ثم حدد الأمان.

    لقطة شاشة لسهم يشير إلى علامة التبويب

  7. لاحظ أنه تتم تعبئة الحقول من الملف الذي تم استيراده.

  8. لا تخرج من هذه الصفحة.

المهمة: مراجعة التعريفات وضبطها

لمراجعة التعريفات وضبطها، اتبع الخطوات الآتية:

  1. حدد علامة التبويب التعريف.

  2. الرجاء قضاء بضع دقائق لمراجعة العمليات التي تم استيرادها.

  3. لاحظ دائرة المعلومات الزرقاء بجوار GetInvoice.

  4. حدد العملية GetInvoice.

    لقطة شاشة تُظهر إجراء الحصول على الفاتورة.

  5. لاحظ أن العملية تشير إلى ملخص مفقود.

  6. أدخل الحصول على الفاتورة كـ ملخص لتحسين قابلية الاستخدام.

    لقطة شاشة لملخص إجراء الحصول على الفاتورة.

  7. لاحظ وجود دائرة المعلومات الزرقاء بجوار العملية PayInvoice والتي تشير إلى وصف مفقود.

  8. أدخل دفع فاتورة كـ ‎الوصف.

  9. احذف كلتا عمليتي NewInvoice لأنك لن تستخدمها.

    لقطة شاشة تُظهر الزر حذف إجراء.

  10. حدد العملية GetInvoiceSchema.

  11. قم بتعديل خيار الرؤية إلى داخلية حتى لا يتمكن الأشخاص من الرؤية في قائمة الإجراءات الخاصة بهم.

  12. حدد تحديث الموصل.

    لقطة شاشة لسهم يشير إلى زر تحديث الموصل.

  13. لا تخرج من هذه الصفحة.

المهمة: اختبار الموصل

اتبع الخطوات التالية لاختبار الموصل:

  1. حدد علامة التبويب الاختبار.

  2. حدد + اتصال جديد.

    لقطة شاشة لسهم يشير إلى زر اتصال جديد.

  3. قم بلصق مفتاح API الذي قمت بحفظه في المهمة 1: مراجعة واجهة برمجة التطبيقات (API) ثم حدد إنشاء اتصال.

  4. حدد الزر تحديث.

    لقطة شاشة لسهم يشير إلى زر التحديث.

  5. حدد ListInvoiceTypes > عملية الاختبار.

    لقطة شاشة لسهم يشير إلى الزر

  6. يفترض أن ترى بيانات أنواع الفاتورة في منطقة النص الأساسي.

    لقطة شاشة لأنواع الفواتير.

المهمة: استخدام الموصل المخصص في تطبيق اللوحة

في هذه المهمة، ستقوم بإنشاء تطبيق لوحة واستخدام الارتباط المخصص الذي قمت بإنشائه لعرض قائمة الفواتير.

  1. انتقل إلى Power Apps maker portal وتأكد من وجودك فِي البيئة الصحيحة.

  2. حدد الحلول ثم افتح الحل Contoso invoicing الذي قمت بإنشائه.

  3. حدد + جديد وبعد ذلك، حدد التطبيق > تطبيق اللوحة.

    لقطة شاشة تُظهر زر إنشاء تطبيق لوحة جديدة.

  4. أدخل تطبيق Contoso invoicing بالنسبة لاسم التطبيق، حدد الهاتف لـ "التنسيق" ثم حدد إنشاء.

  5. حدد علامة التبويب البيانات، وحدد + إضافة بيانات، وقم بتوسيع الموصلات، ثم حدد الموصل المخصص لـ Contoso invoicing الذي قمت بإنشائه.

    لقطة شاشة توضح الموصل المخصص لـ contoso invoicing.

  6. حدد + إضافة موصل.

  7. قم بلصق مفتاح API الذي قمت بحفظه في الهامة 1: مراجعة واجهة برمجة التطبيقات (API) ثم حدد اتصال.

  8. حدد فهمت في النافذة المنبثقة للتحذير المميز.

  9. حدد علامة التبويب طريقة عرض الشجرة.

  10. حدد + إدراج ثم حدد معرض رأسي.

    لقطة شاشة تُظهر زر إدراج معرض رأسي.

  11. حدد ContosoInvoicing للبيانات.

    لقطة شاشة تعرض مربع حوار تحديد البيانات.

  12. قم بتعيين قيمة Items إلَى القيمة أدناه:

    ContosoInvoicing.ListInvoices().invoices

    لقطة شاشة تُظهر قيمة عناصر المعرض.

  13. قم بتوسيع المعرض وحدد العنوان الفرعي.

  14. قم بتعيين قيمة Text للعنوان الفرعي إلى ThisItem.amount.

  15. قم بتوسيع المعرض وحدد العنوان داخل المعرض.

  16. قم بتعيين قيمة Text للعنوان إلى ThisItem.accountName.

    لقطة شاشة تُظهر قيمة نص العنوان.

  17. يجب أن يبدو المعرض الآن مثل الصورة أدناه.

    لقطة شاشة تُظهر المعرض.