הפניה למשתנה סביבה

הפניה זו למשתנה סביבה מכסה את כל הגדרות התצורה עבור דוגמאות Power Platform Playwright. לפיתוח מקומי, הגדר משתנים אלה ב- packages/e2e-tests/.env. ב- CI/CD, הגדר אותם כסודות צינור או משתנים. לקבלת הוראות ספציפיות לצינור, ראה שילוב CI/CD.

משתני אימות

משתנים אלה שולטים באופן אימות מסגרת הבדיקה מול שירותי Power Platform.

משתנה	נדרש	Description
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:

משתנה	Description
AZURE_KEYVAULT_URL	Key Vault URL זו, לדוגמה, https://<vault-name>.vault.azure.net/
AZURE_CERTIFICATE_NAME	שם האישור המאוחסן Key Vault
AZURE_TENANT_ID	Microsoft Entra מזהה דייר
AZURE_CLIENT_ID	(אופציונלי) מזהה לקוח ראשי של שירות עבור זהות מאוחדת

משתני כתובת URL של יישום

משתנים אלה מציינים את כתובות ה- URL של היישומים תחת בדיקה.

משתנה	נדרש	Description
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. אל תגדיר אותם ישירות.

נתיב	Description
.playwright-ms-auth/state-<email>.json	Power Apps אימות (בדיקות UX של Canvas/Gen)
.playwright-ms-auth/state-mda-<email>.json	Dynamics 365 אימות (בדיקות MDA)

עקוף את ספריית מצב האחסון:

MS_AUTH_STORAGE_DIR=../../.auth

דגל CI/CD

השתמש בדגל זה כדי לכוונן את אופן הפעולה של הבדיקה עבור בסביבות שילוב רציף.

משתנה	ברירת מחדל	Description
CI	false	הגדר ל- true CI כדי להפוך את retries: 1, , forbidOnlyוזמן קצוב מחמירים יותר לזמינים

Playwright מקריא באופן CI אוטומטי. אין צורך להגדיר אותו ב- — סביבה קווי .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 - repo לא כולל אותם.
• לעולם אל תבצע .playwright-ms-auth/ קבצי מצב. הם מכילים אסימוני הפעלה.
• ב- CI/CD, להגדיר את כל הסודות דרך החנות הסודית של צינור, לא in checked-in YAML.

השלבים הבאים

• מדריך אימות
• שילוב CI/CD
• חומר עזר לתצורה

למידע נוסף

• מבט כולל על אימות
• תחילת העבודה