Napomena
Za pristup ovoj stranici potrebna je autorizacija. Možete se pokušati prijaviti ili promijeniti direktorije.
Za pristup ovoj stranici potrebna je autorizacija. Možete pokušati promijeniti direktorije.
Referenca varijabli okruženja obuhvaća sve konfiguracijske postavke za uzorke značajke Power Platform Playwright. Za lokalni razvoj postavite ove varijable u packages/e2e-tests/.env. U CI/CD-u postavite ih kao tajne kanala ili varijable. Upute specifične za kanal potražite u članku Integracija CI/CD-a.
Varijable provjere autentičnosti
Te varijable kontroliraju način provjere autentičnosti testnog okvira za servise platforme Power Platform.
| Varijabla | Obavezno | Opis |
|---|---|---|
MS_AUTH_EMAIL |
Da | Adresa e-pošte testnog korisničkog računa |
MS_AUTH_CREDENTIAL_TYPE |
Da | Način provjere autentičnosti: password ili certificate |
MS_USER_PASSWORD |
Ako credential_type=password |
Lozinka za testnog korisnika |
MS_AUTH_CREDENTIAL_PROVIDER |
Ako credential_type=certificate |
Izvor certifikata: local-file ili azure-keyvault |
MS_AUTH_LOCAL_FILE_PATH |
Ako provider=local-file |
Relativni put do datoteke .pfx certifikata |
MS_AUTH_CERTIFICATE_PASSWORD |
Ne | Lozinka za certifikat .pfx (ako je zaštićena) |
Azure Key Vault varijabli
Obavezno kada MS_AUTH_CREDENTIAL_PROVIDER=azure-keyvault:
| Varijabla | Opis |
|---|---|
AZURE_KEYVAULT_URL |
Key Vault URL adresa, npr. https://<vault-name>.vault.azure.net/ |
AZURE_CERTIFICATE_NAME |
Naziv certifikata pohranjenog u Key Vault |
AZURE_TENANT_ID |
Microsoft Entra ID klijenta |
AZURE_CLIENT_ID |
(Neobavezno) ID klijenta upravitelja servisa za vanjski identitet |
Varijable URL-a aplikacije
Te varijable određuju URL-ove aplikacija koje se testi.
| Varijabla | Obavezno | Opis |
|---|---|---|
CANVAS_APP_URL |
Za testove platna | URL cijelog načina reprodukcije aplikacije za crtanje, uključujući ?tenantId=<id> |
MODEL_DRIVEN_APP_URL |
Za testove aplikacija utemeljene na modelu | Potpuni URL aplikacije utemeljene na modelu (/main.aspx?appid=<id>) |
CUSTOM_PAGE_NAME |
Za prilagođene testove stranica | Zaslonski naziv prilagođene stavke karte web-mjesta, kao što je AccountsCustomPage |
Sastavljanje URL-a aplikacije platna
Koristi buildCanvasAppUrlFromEnv() se iz kompleta alata za sastavljanje URL-a od pojedinačnih dijelova ako je potrebno:
import { buildCanvasAppUrlFromEnv } from 'power-platform-playwright-toolkit';
const url = buildCanvasAppUrlFromEnv();
// Reads CANVAS_APP_URL from environment
Možete je i izričito postaviti u programu .env:
CANVAS_APP_URL=https://apps.powerapps.com/play/e/default-<tenant-id>/a/<app-id>?tenantId=<tenant-id>
Dohvaćanje URL-a aplikacije utemeljene na modelu
Slijedite ove korake da biste pronašli točan URL za aplikaciju utemeljenu na modelu.
- Otvorite aplikaciju utemeljenu na modelu u načinu reprodukcije.
- Kopirajte URL iz adresne trake preglednika.
- Uklonite parametre upita nakon
appid=<guid>toga koji su specifični za sesiju.
MODEL_DRIVEN_APP_URL=https://<org>.crm.dynamics.com/main.aspx?appid=<app-guid>
Varijable stanja pohrane
Komplet alata izračunava te varijable iz MS_AUTH_EMAIL. Nemojte ih izravno postaviti.
| Put | Opis |
|---|---|
.playwright-ms-auth/state-<email>.json |
Power Apps auth state (testovi platna / Gen UX) |
.playwright-ms-auth/state-mda-<email>.json |
Dynamics 365 stanja aute (MDA testovi) |
Nadjačavanje direktorija stanja pohrane:
MS_AUTH_STORAGE_DIR=../../.auth
Ci/CD zastavica
Pomoću ove zastavice prilagodite ponašanje testiranja u okruženjima s neprekinutom integracijom.
| Varijabla | Zadano | Opis |
|---|---|---|
CI |
false |
Postavljeno na true u CI za omogućavanje retries: 1, forbidOnlyi strožih vremenskih ograničenja |
Playwright će automatski čitati CI . Ne morate je postaviti u – okruženjima .env cjevovoda koja je postavlja konvencija.
Ogledna .env datoteka
Koristite ove primjere kao početnu točku za lokalnu .env datoteku.
# 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
Za provjeru autentičnosti certifikata:
# 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/...
Za 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/...
Sigurnosne napomene
Slijedite ove prakse da biste vjerodajnice i podatke sesije zaštitili.
- Nikada nemojte izvršiti
.envdatoteke za izvornu kontrolu. U.gitignorerepozito programu isključuju se. - Nikada nemojte potvrđivanje
.playwright-ms-auth/datoteka stanja. Sadrže tokene sesije. - U CI/CD-u postavite sve tajne putem tajnog spremišta kanala, a ne u prijavljenom SERVISU YAML.