مرجع المتغيرات البيئية

يغطي مرجع متغيرات البيئة هذا جميع إعدادات التكوين لعينات Power Platform Playwright. للتطوير المحلي، قم بتعيين هذه المتغيرات في packages/e2e-tests/.env. في CI/CD، قم بتعيينها كأسرار أو متغيرات البنية الأساسية لبرنامج ربط العمليات التجارية. للحصول على إرشادات خاصة بالبنية الأساسية لبرنامج ربط العمليات التجارية، راجع تكامل CI/CD.

متغيرات المصادقة

تتحكم هذه المتغيرات في كيفية مصادقة إطار الاختبار مقابل خدمات Power Platform.

المتغير	مطلوب	الوصف
MS_AUTH_EMAIL	‏‏نعم‬	عنوان البريد الإلكتروني لحساب مستخدم الاختبار
MS_AUTH_CREDENTIAL_TYPE	‏‏نعم‬	أسلوب المصادقة: password أو certificate
MS_USER_PASSWORD	اذا credential_type=password	كلمة المرور لمستخدم الاختبار
MS_AUTH_CREDENTIAL_PROVIDER	اذا credential_type=certificate	مصدر الشهادة: local-file أو azure-keyvault
MS_AUTH_LOCAL_FILE_PATH	اذا provider=local-file	المسار النسبي لملف الشهادة .pfx
MS_AUTH_CERTIFICATE_PASSWORD	لا.	كلمة المرور للشهادة .pfx (إذا كانت محمية)

متغيرات Azure Key Vault

مطلوب عند MS_AUTH_CREDENTIAL_PROVIDER=azure-keyvault:

المتغير	الوصف
AZURE_KEYVAULT_URL	عنوان URL Key Vault، على سبيل المثال، https://<vault-name>.vault.azure.net/
AZURE_CERTIFICATE_NAME	اسم الشهادة المخزنة في Key Vault
AZURE_TENANT_ID	معرف المستأجر Microsoft Entra
AZURE_CLIENT_ID	(اختياري) معرف عميل كيان الخدمة للهوية الموحدة

متغيرات عنوان URL للتطبيق

تحدد هذه المتغيرات عناوين URL للتطبيقات قيد الاختبار.

المتغير	مطلوب	الوصف
CANVAS_APP_URL	لاختبارات اللوحة	عنوان URL الكامل لوضع التشغيل لتطبيق اللوحة، بما في ذلك ?tenantId=<id>
MODEL_DRIVEN_APP_URL	لاختبارات التطبيق المستندة إلى النموذج	عنوان URL الكامل للتطبيق المستند إلى النموذج (/main.aspx?appid=<id>)
CUSTOM_PAGE_NAME	لاختبارات الصفحة المخصصة	اسم العرض لعنصر خريطة موقع الصفحة المخصصة، مثل AccountsCustomPage

إنشاء عنوان URL لتطبيق اللوحة

استخدم buildCanvasAppUrlFromEnv() من مجموعة الأدوات لإنشاء عنوان URL من أجزاء فردية إذا لزم الأمر:

import { buildCanvasAppUrlFromEnv } from 'power-platform-playwright-toolkit';

const url = buildCanvasAppUrlFromEnv();
// Reads CANVAS_APP_URL from environment

أو قم بتعيينه بشكل صريح في .env:

CANVAS_APP_URL=https://apps.powerapps.com/play/e/default-<tenant-id>/a/<app-id>?tenantId=<tenant-id>

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

اتبع هذه الخطوات للعثور على عنوان URL الصحيح للتطبيق المستند إلى النموذج.

1. افتح التطبيق المستند إلى النموذج في وضع التشغيل.
2. انسخ عنوان URL من شريط عناوين المستعرض.
3. قم بإزالة معلمات الاستعلام بعد appid=<guid> أن تكون خاصة بجلسة العمل.

MODEL_DRIVEN_APP_URL=https://<org>.crm.dynamics.com/main.aspx?appid=<app-guid>

متغيرات حالة التخزين

تحسب مجموعة الأدوات هذه المتغيرات من MS_AUTH_EMAIL. لا تقم بتعيينها مباشرة.

المسار	الوصف
.playwright-ms-auth/state-<email>.json	Power Apps حالة المصادقة (اختبارات canvas/Gen UX)
.playwright-ms-auth/state-mda-<email>.json	Dynamics 365 حالة المصادقة (اختبارات MDA)

تجاوز دليل حالة التخزين:

MS_AUTH_STORAGE_DIR=../../.auth

علامة CI/CD

استخدم هذه العلامة لضبط سلوك الاختبار لبيئات التكامل المستمر.

المتغير	Default	الوصف
CI	false	قم بتعيين إلى true في CI لتمكين retries: 1المهلات forbidOnlyو و الأكثر صرامة

يقرأ CI Playwright تلقائيا. لا تحتاج إلى تعيينه في .env — بيئات البنية الأساسية لبرنامج ربط العمليات التجارية تعيينه حسب الاصطلاح.

نموذج ملف .env

استخدم هذه الأمثلة كنقطة بداية للملف المحلي .env .

# Authentication
MS_AUTH_EMAIL=testuser@contoso.com
MS_AUTH_CREDENTIAL_TYPE=password
MS_USER_PASSWORD=<your-password>

# App URLs
CANVAS_APP_URL=https://apps.powerapps.com/play/e/default-<tenant-id>/a/<app-id>?tenantId=<tenant-id>
MODEL_DRIVEN_APP_URL=https://<org>.crm.dynamics.com/main.aspx?appid=<app-id>
CUSTOM_PAGE_NAME=AccountsCustomPage

لمصادقة الشهادة:

# Authentication (certificate)
MS_AUTH_EMAIL=testuser@contoso.com
MS_AUTH_CREDENTIAL_TYPE=certificate
MS_AUTH_CREDENTIAL_PROVIDER=local-file
MS_AUTH_LOCAL_FILE_PATH=../../cert/testuser.pfx
MS_AUTH_CERTIFICATE_PASSWORD=<pfx-password>

# App URLs
CANVAS_APP_URL=https://apps.powerapps.com/play/...
MODEL_DRIVEN_APP_URL=https://<org>.crm.dynamics.com/...

على سبيل Azure Key Vault:

# Authentication (Key Vault)
MS_AUTH_EMAIL=testuser@contoso.com
MS_AUTH_CREDENTIAL_TYPE=certificate
MS_AUTH_CREDENTIAL_PROVIDER=azure-keyvault
AZURE_KEYVAULT_URL=https://mykeyvault.vault.azure.net/
AZURE_CERTIFICATE_NAME=playwright-test-cert
AZURE_TENANT_ID=<tenant-guid>

# App URLs
CANVAS_APP_URL=https://apps.powerapps.com/play/...
MODEL_DRIVEN_APP_URL=https://<org>.crm.dynamics.com/...

ملاحظات الأمان

اتبع هذه الممارسات للحفاظ على بيانات الاعتماد وبيانات الجلسة آمنة.

• لا تقم أبدا بتثبيت .env الملفات بالتحكم بالمصادر. في .gitignore المستودع يستبعدها.
• لا تقم أبدا بتثبيت .playwright-ms-auth/ ملفات الحالة. وهي تحتوي على رموز جلسة العمل المميزة.
• في CI/CD، قم بتعيين جميع الأسرار عبر مخزن البيانات السرية للبنية الأساسية لبرنامج ربط العمليات التجارية، وليس في YAML المدقق.

الخطوات التالية

• دليل المصادقة
• تكامل CI/CD
• مرجع التكوين

راجع أيضًا

• نظرة عامة على المصادقة
• بدء الاستخدام