السابق

التالي

تمرين - استخدام قالب نهج لتعيين عنوان URL المضيف ديناميكياً

مكتمل

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

يتطلب هذا التمرين تثبيت Python والوصول إلى موجه الأوامر على الجهاز الذي تستخدمه للتمرين.

هام

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

ملاحظة

قم بتنزيل الملف التالي إلى الكمبيوتر المحلي لديك لإكمال مشغّلات Contoso Invoicing. حدّد الزر "تنزيل" في منتصف الشاشة على اليمين.

الهامة 1: استيراد حل

في هذه الهامة، ستستورد حلاً غير مُدار يحتوي على موصل مخصص لـ Contoso Invoicing. وستستخدم هذا الموصل لإكمال المهام الموجودة في هذا التمرين.

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

2. حدّد حل > استيراد الحلول.

3. حدّد استعراض.

4. حدّد الحل ContosoInvoicingPolicyTemplates_1_0_0_2.zip ثم حدّد فتح.

5. حدّد التالي.

6. حدّد استيراد ثم انتظر حتى يكتمل الاستيراد. من المفترض أن تتلقى رسالة نجاح بعد اكتمال الاستيراد.

7. حدّد نشر جميع التخصيصات وانتظر حتى اكتمال النشر.

8. افتح الحل Contoso Invoicing - قوالب النهج الذي قمت باستيراده.

   من المفترض أن ترى مكون الموصل المخصص Contoso invoicing - النهج.

   

الهامة 2: تثبيت Microsoft Power Platform CLI

تتضمن Microsoft Power Platform CLI أداة سطر الأوامر paconn التي تم تصميمها للمساعدة على تطوير الموصلات المخصصة لـ Microsoft Power Platform. تستخدم أداة paconn وقت تشغيل Python، ومن ثم ستقوم بتثبيتها أيضًا.

1. انتقل إلى تنزيل Python وحدّد تنزيل Python. يمكنك استخدام أي إصدار أعلى من 3.5.

2. حدّد ملف .exe الذي تم تنزيله لبدء عملية التثبيت.

3. حدّد خانة الاختيار إضافة Python xx إلى المسار، وحدّد تثبيت، ثم انتظر حتى يكتمل التثبيت.

   

4. أغلق معالج التثبيت بعد اكتمال عملية التثبيت.

5. ابدأ تشغيل موجه الأوامر ثم قم بتشغيل الأمر التالي لتثبيت paconn.

   pip install paconn

   

6. انتظر حتى تكتمل عملية التثبيت.

الهامة 3: تنزيل الموصل محليًا

في هذه الهامة، ستقوم بتنزيل ملفات تعريف الموصل محليًا بحيث يمكنك إضافة خاصية عنوان URL المضيف.

1. قم بتشغيل أمر تسجيل الدخول.

   paconn login

2. انسخ التعليمة البرمجية المزودة.

3. في المستعرض، سجِّل الدخول باستخدام نفس بيانات الاعتماد مثل بيئتك. انتقل إلى تسجيل الدخول إلى جهاز Microsoft، والصق التعليمة البرمجية التي نسختها، ثم حدّد التالي.

4. قم بتقديم بيانات الاعتماد الخاصة بك.

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

6. من المفترض أن تحصل على رسالة نجاح تسجيل الدخول.

   

7. ارجع إلى موجه الأوامر وقم بتشغيل أمر التنزيل.

   paconn download

8. عند المطالبة بتحديد بيئة، أدخل رقمًا للبيئة التي قمت بتثبيت الحل فيها، ثم اضغط على مفتاح الإدخال.

9. يجب إدراج موصل واحد فقط: نهج Contoso Invoicing. اضغط على مفتاح الإدخال مرة أخرى لتحديد هذا الموصل.

10. يجب أن يكتمل التنزيل بنجاح. لاحظ الموقع الذي تم تنزيل الموصل به.

الهامة 4: تحرير apiProperties.json لإضافة خاصية عنوان URL المضيف

في هذه الهامة، ستقوم بتحرير ملف apiProperties.json لتكوين خاصية hostUrl. عند تكوين الخاصية، ستتم مطالبة المستخدمين الذين يقومون بإنشاء اتصال بهذه القيمة مع مفتاح API.

1. انتقل إلى المجلد الذي قمت بتنزيله في الهامة السابقة، وافتح ملف apiProperties.json.

2. الصق JSON داخل ConnectionParameters، قبل خاصية api_key.

   "hostUrl": {
           "type": "string",
           "uiDefinition": {
             "constraints": {
               "required": "true"
             },
             "description": "Specify your API Url e.g. https://test.contoso.com",
             "displayName": "API URL",
             "tooltip": "Specify your API Url e.g. https://test.contoso.com"
           }
         },
   

   

3. احفظ تغييراتك.

4. انتقل إلى موجه الأوامر وقم بتغيير الدليل إلى المجلد الذي قمت بتنزيله.

5. قم بتشغيل أمر التحديث.

   paconn update --api-def apiDefinition.swagger.json --api-prop apiProperties.json --icon icon.png

6. حدّد البيئة الصحيحة التي قمت فيها بتثبيت الحل.

7. حدّد موصل Contoso Invoicing - النهج.

يجب أن يكتمل التحديث بنجاح.

الهامة 5: إضافة نهج تعيين اسم المضيف

في هذه الهامة، ستقوم بتكوين قالب نهج تعيين اسم المضيف لاستخدام خاصية الاتصال التي قمت بتكوينها في الهامة السابقة.

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

2. حدّد الحلول ثم افتح الحل Contoso Invoicing - قوالب النهج الذي قمت باستيراده.

3. حدّد الموصل المخصص Contoso Invoicing - النهج ثم حدّد تحرير.

   

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

5. قم بالتمرير لأسفل إلى قسم النُهُج وحدّد + نهج جديد.

   

6. أدخل نهج عنوان URL المضيف لـ الاسم، ثم حدّد تعيين عنوان URL المضيف لـ القالب.

   

7. أدخل @connectionParameters('hostUrl') لـ قالب عنوان URL ثم حدّد تحديث الموصل.

   

   يجب أن يكتمل تحديث الموصل بنجاح.

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

الهامة 6: الاختبار

في هذه الهامة، ستنشئ اتصالاً باستخدام التكوين الجديد ثم ستختبره.

1. ابدأ نافذة مستعرض جديدة، ثم انتقل إلى Contoso Invoicing.

2. حدّد ارتباط مفتاح API.

3. انسخ مفتاح API.

4. ارجع إلى الموصل.

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

6. حدّد + اتصال جديد.

   

7. أدخل https://contosoinvoicingtest.azurewebsites.net/ لـ API URL، والصق مفتاح API الذي نسخته، ثم حدّد إنشاء اتصال.

8. حدّد تحديث الاتصالات.

   

9. حدّد ListInvoice > عملية الاختبار.

   

   يجب أن يرجع الاختبار الفواتير.

   

متابعة