اختبار التطبيقات المستندة إلى النموذج باستخدام Test Engine (مهمل)

ملحوظة

تم إهمال محرك الاختبار وسيتم إزالته في إصدار مستقبلي. استخدم Power Platform Playwright samples لقدرات أتمتة الاختبار في Power Platform وخدمات Dynamics 365.

يتطلب اختبار التطبيق المستند إلى النموذج باستخدام Test Engine الخطوات التالية:

  1. إنشاء خطة اختبار
  2. إعداد المستخدم
  3. قم بتشغيل الاختبار
  4. عرض النتائج

إنشاء خطة اختبار

أنشئ ملف yaml باستخدام مخطط خطة الاختبار الموضح بتنسيق YAML لمحرك اختبار Power Apps (مهمل).

تلميح

راجع الخطط النموذجية المتاحة في مستودع GitHub.

تمكين المعاينة

حاليا، تتطلب جميع إمكانات اختبار ملحق التطبيق المستند إلى النموذج استخدام وظائف المعاينة. لتمكين هذه التقنيات، أضف Preview إلى القائمة في allowPowerFxNamespaces extensionModules الخاصة بtestSettings.

يوضح لك هذا المثال كيفية إضافة هذا:

testSettings:
  extensionModules:
    enable: true
    allowPowerFxNamespaces:
    - Preview

إعداد المستخدم

يحتوي Test Engine حاليا على طرق المصادقة التالية:

الطريقة الوصف
حالة التخزين تخزين حالة المستخدم المصادق عليها محليا في ملف تعريف المستخدم باستخدام Microsoft Windows Data Protection API
Dataverse تخزين حالة المستخدم المحَقق منها داخل Dataverse باستخدام مفتاح مُدار للعميل ومُشفر بشهادة X.509، وذلك باستخدام ASP.NET Core Data Protection

لا يمكنك تخزين بيانات اعتماد الاختبار في ملفات خطة الاختبار. يجب عليك تحديد Storagestate أو Dataverse كموقع آمن لتخزين بيانات الاعتماد. يحتوي ملف خطة الاختبار على مراجع إلى متغيرات البيئة التي يتم استخدامها لشخصية المستخدم. على سبيل المثال، يشير قصاصة YAML التالية إلى استخدام user1Email متغيرات البيئة:

environmentVariables:
  users:
    - personaName: User1
      emailKey: user1Email

عرض المستخدمين لمزيد من المعلومات.

استخدم البرنامج النصي PowerShell التالي لتخزين اسم المستخدم في متغيرات البيئة الخاصة بك.

$env:user1Email = "someone@example.com"

قم بتشغيل الاختبار

أستخدم الأمر PAC CLI pac test run لتشغيل خطة الاختبار الخاصة بك.

المعلمات المطلوبة

سوف تحتَاج إِلى توفِير المعلومَات التَالِية:

  • --test-plan-fileالمسار إلى ملف خطة الاختبار الخاصة بك:
  • --tenantمعرف المستأجر الخاص بك:
  • --environment-idمعرف البيئة الخاص بك:
  • --domain: رابط الويب لصفحة التطبيق المعتمد على النموذج لاختباره

تنسيقات عناوين URL للتطبيقات المستندة إلى النموذج

بالنسبة للتطبيقات المستندة إلى النموذج، تختلف المعلمة --domain بناء على نوع الصفحة التي تختبرها. يجب أن يحدد تنسيق عنوان URL الصحيح pagetype استنادا إلى سيناريو الاختبار الخاص بك:

# For custom pages
pac test run `
   --provider mda `
   --test-plan-file your-testplan.te.yaml `
   --tenant your-tenantid-guid-value `
   --environment-id your-environmentid-guid-value `
   --domain "https://contoso.crm.dynamics.com/main.aspx?appid=00001111-aaaa-2222-bbbb-3333cccc4444&pagetype=custom&name=dev_home_c8017"

# For entity lists (views)
pac test run `
   --provider mda `
   --test-plan-file your-testplan.te.yaml `
   --tenant your-tenantid-guid-value `
   --environment-id your-environmentid-guid-value `
   --domain "https://contoso.crm.dynamics.com/main.aspx?appid=00001111-aaaa-2222-bbbb-3333cccc4444&pagetype=entitylist&etn=account&viewid=5a84c584-df1c-ed11-9db0-000d3a991110"

# For entity records (forms)
pac test run `
   --provider mda `
   --test-plan-file your-testplan.te.yaml `
   --tenant your-tenantid-guid-value `
   --environment-id your-environmentid-guid-value `
   --domain "https://contoso.crm.dynamics.com/main.aspx?appid=00001111-aaaa-2222-bbbb-3333cccc4444&pagetype=entityrecord&etn=account&id=72e0e163-df1c-ed11-9db0-000d3a991110"

تكامل Dataverse

لتمكين Dataverse التكامل مع اختبارات التطبيق المستند إلى النموذج، أضف المعلمة enableDataverseFunctions في testSettings:

testSettings:
  extensionModules:
    enable: true
    allowPowerFxNamespaces:
    - Preview
    parameters:
      enableDataverseFunctions: true

عند تمكين تكامل Dataverse، يطلب منك فتح Azure CLI مع مستخدم أو كيان خدمة له حقوق في بيئة Dataverse. يمكنك استخدام الأمر: az login مزيد من المعلومات: تسجيل الدخول باستخدام Azure CLI.

يتم الحصول على عنوان URL لواجهة API في Dataverse المستخدم للتكامل إما من اسم النطاق المضيف لمعلمة تشغيل اختبار pac--domain أو عن طريق تحديد متغير بيئة PowerShell المسمى DATAVERSE_URL.

عرض النتائج

عند اكتمال الاختبارات، يمكنك عرض نتائج الاختبار في .trx الملف الموجود في دليل الإخراج. يحتوي هذا المجلد على أي لقطات شاشة أو مقاطع فيديو تم التقاطها بواسطة الاختبارات الخاصة بك عند recordVideo تعيينها على true في خطة الاختبار yaml.