Referință variabile de mediu

Această referință pentru variabilele de mediu acoperă toate setările de configurare pentru eșantioanele Power Platform Playwright. Pentru dezvoltare locală, setați aceste variabile în packages/e2e-tests/.env. În CI/CD, setați-le ca secrete de canal sau variabile. Pentru instrucțiuni specifice canalului, consultați Integrarea CI/CD.

Variabile de autentificare

Aceste variabile controlează modul în care cadrul de testare se autentifică în raport cu serviciile Power Platform.

Variabilă	Obligatoriu	Descriere
`MS_AUTH_EMAIL`	Da	Adresa de e-mail a contului de utilizator de test
`MS_AUTH_CREDENTIAL_TYPE`	Da	Metoda de autentificare: `password` sau `certificate`
`MS_USER_PASSWORD`	Dacă `credential_type=password`	Parolă pentru utilizatorul de test
`MS_AUTH_CREDENTIAL_PROVIDER`	Dacă `credential_type=certificate`	Sursă certificat: `local-file` sau `azure-keyvault`
`MS_AUTH_LOCAL_FILE_PATH`	Dacă `provider=local-file`	Cale relativă `.pfx` la fișierul certificat
`MS_AUTH_CERTIFICATE_PASSWORD`	Nu	Parolă pentru `.pfx` certificat (dacă este protejat)

Azure Key Vault variabile

Obligatoriu atunci când MS_AUTH_CREDENTIAL_PROVIDER=azure-keyvault:

Variabilă	Descriere
`AZURE_KEYVAULT_URL`	Key Vault URL, de exemplu, `https://<vault-name>.vault.azure.net/`
`AZURE_CERTIFICATE_NAME`	Numele certificatului stocat în Key Vault
`AZURE_TENANT_ID`	ID entitate găzduită Microsoft Entra
`AZURE_CLIENT_ID`	(Opțional) ID-ul clientului principal de serviciu pentru identitatea federativă

Variabile URL aplicație

Aceste variabile specifică URL-urile aplicațiilor de sub test.

Variabilă	Obligatoriu	Descriere
`CANVAS_APP_URL`	Pentru teste pe pânză	URL-ul complet al modului de redare al aplicației pânză, inclusiv `?tenantId=<id>`
`MODEL_DRIVEN_APP_URL`	Pentru testele de aplicație bazate pe modele	URL complet al aplicației bazate pe model (`/main.aspx?appid=<id>`)
`CUSTOM_PAGE_NAME`	Pentru teste de pagină particularizate	Numele afișat al elementului hartă site pagină particularizat, cum ar fi `AccountsCustomPage`

Construiți URL-ul aplicației pânză

Utilizați buildCanvasAppUrlFromEnv() din kitul de instrumente pentru a construi URL-ul de la părți individuale, dacă este necesar:

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

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

Sau setați-l explicit în .env:

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

Obțineți URL-ul aplicației bazate pe model

Urmați acești pași pentru a găsi URL-ul corect pentru aplicația dvs. bazată pe model.

Deschideți aplicația bazată pe modele în modul de redare.
Copiați URL-ul din bara de adrese a browserului.
Eliminați parametrii interogării după appid=<guid> aceea, specifici sesiunii.

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

Variabile de stare de stocare

Kitul de instrumente calculează aceste variabile din MS_AUTH_EMAIL. Nu le setați direct.

Cale	Descriere
`.playwright-ms-auth/state-<email>.json`	Power Apps stare de autentificare (teste gen UX/pânză)
`.playwright-ms-auth/state-mda-<email>.json`	Dynamics 365 stare de autentificare (teste MDA)

Înlocuiți directorul stării de stocare:

MS_AUTH_STORAGE_DIR=../../.auth

Semnalizator CI/CD

Utilizați această semnalizare pentru a ajusta comportamentul de testare pentru mediile de integrare continuă.

Variabilă	Implicită	Descriere
`CI`	`false`	Setați la `true` în CI pentru a activa `retries: 1`, `forbidOnly`și expirări mai stricte

Playwright citește CI automat. Nu trebuie să îl setați în .env - mediile de canalizare setate după convenție.

Exemplu de fișier .env

Utilizați aceste exemple ca punct de plecare pentru fișierul local .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

Pentru autentificarea certificatului:

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

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

Note de securitate

Urmați aceste practici pentru a păstra acreditările și datele sesiunii securizate.

Nu comiteți .env niciodată fișierele în controlul sursei. Depozitul .gitignore din repo le exclude.
Nu comiteți .playwright-ms-auth/ niciodată fișiere de stare. Acestea conțin tokenuri de sesiune.
În CI/CD, setați toate secretele prin depozitul secret al canalului, nu în YAML arhivat.