Қоршаған орта айнымалыларына сілтеме

Бұл орта айнымалыларына сілтеме 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 variables

Қажет болғанда MS_AUTH_CREDENTIAL_PROVIDER=azure-keyvault:

Айнымалы мән	Сипаттама
`AZURE_KEYVAULT_URL`	Key Vault URL, мысалы, `https://<vault-name>.vault.azure.net/`
`AZURE_CERTIFICATE_NAME`	Key Vault-та сақталған сертификаттың атауы
`AZURE_TENANT_ID`	Microsoft Entra tenant ID
`AZURE_CLIENT_ID`	(Міндетті емес) Федеративті сәйкестендіру үшін қызмет негізгі клиент идентификаторы

Қосымша URL айнымалылары

Бұл айнымалылар сынақтан өтетін қосымшаларның URL-дерін анықтайды.

Айнымалы мән	Қажетті	Сипаттама
`CANVAS_APP_URL`	Кенеп сынақтары үшін	Canvas қосымшасының толық ойнату режиміндегі URL-жайы, оның ішінде `?tenantId=<id>`
`MODEL_DRIVEN_APP_URL`	Модельге негізделген қосымша тесттері үшін	Сіздің модельдік негізделген қосымшаңыздың толық URL мекенжайы (`/main.aspx?appid=<id>`)
`CUSTOM_PAGE_NAME`	Арнайы бет тесттері үшін	Custom page sitemap элементінің көрсету атауы, мысалы, `AccountsCustomPage`

Canvas қосымшасының 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 табыңыз.

Модельге негізделген қосымшаны ойнау режимінде ашыңыз.
URL-ді браузердің мекенжай жолағынан көшіріңіз.
Содан кейін сұрау параметрлерін 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 auth state (canvas/Gen UX тесттері)
`.playwright-ms-auth/state-mda-<email>.json`	Dynamics 365 аутентификация күйі (MDA тесттері)

Сақтау күйі каталогын басып шығару:

MS_AUTH_STORAGE_DIR=../../.auth

CI/CD туы

Бұл жалауды үздіксіз интеграция ортасына арналған тест мінез-құлқын реттеу үшін қолданыңыз.

Айнымалы мән	Әдепкі	Сипаттама
`CI`	`false`	CI-ге орнатып `true` , `retries: 1`, `forbidOnly`, және тайм-ауттарды қатаң ету

Драматург автоматты түрде оқиды CI . Оны орнатудың қажеті .env жоқ — pipeline орталары оны дәстүр бойынша орнатады.

.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/...

For 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-де емес.