opomba,
Dostop do te strani zahteva pooblastilo. Poskusite se vpisati alispremeniti imenike.
Dostop do te strani zahteva pooblastilo. Poskusite lahko spremeniti imenike.
Ta sklic na spremenljivke okolja zajema vse nastavitve konfiguracije za vzorce Power Platform Playwright. Za lokalni razvoj nastavite te spremenljivke v packages/e2e-tests/.env. V CI/CD jih nastavite kot skrivnosti cevovoda ali spremenljivke. Navodila za posamezne cevovode najdete v članku Integracija z CI/CD-jem.
Spremenljivke preverjanja pristnosti
Te spremenljivke nadzirajo, kako se preverjanje pristnosti preskusnega ogrodja preverja v storitvah Power Platform.
| Spremenljivka | Zahtevano | Description |
|---|---|---|
MS_AUTH_EMAIL |
Da | E-poštni naslov preskusnega uporabniškega računa |
MS_AUTH_CREDENTIAL_TYPE |
Da | Način preverjanja pristnosti: password ali certificate |
MS_USER_PASSWORD |
Če credential_type=password |
Geslo za preskusnega uporabnika |
MS_AUTH_CREDENTIAL_PROVIDER |
Če credential_type=certificate |
Vir potrdila: local-file ali azure-keyvault |
MS_AUTH_LOCAL_FILE_PATH |
Če provider=local-file |
Relativna pot do datoteke .pfx s potrdilom |
MS_AUTH_CERTIFICATE_PASSWORD |
Ne | Geslo za potrdilo .pfx (če je zaščiteno) |
Azure Key Vault spremenljivke
Zahtevano, ko MS_AUTH_CREDENTIAL_PROVIDER=azure-keyvault:
| Spremenljivka | Description |
|---|---|
AZURE_KEYVAULT_URL |
Key Vault URL, na primer https://<vault-name>.vault.azure.net/ |
AZURE_CERTIFICATE_NAME |
Ime potrdila, shranjenega v Key Vault |
AZURE_TENANT_ID |
Microsoft Entra ID najemnika |
AZURE_CLIENT_ID |
(Izbirno) ID glavnega odjemalca storitve za zunanjo identiteto |
Spremenljivke URL-ja programa
Te spremenljivke določajo URL-je preskusnih aplikacij.
| Spremenljivka | Zahtevano | Description |
|---|---|---|
CANVAS_APP_URL |
Za preskuse platna | URL celotnega načina predvajanja aplikacije platno, vključno z ?tenantId=<id> |
MODEL_DRIVEN_APP_URL |
Za preskuse aplikacij, ki temeljijo na modelu | Celoten URL aplikacije, ki temelji na modelu (/main.aspx?appid=<id>) |
CUSTOM_PAGE_NAME |
Za preskuse strani po meri | Prikazano ime elementa zemljevida mesta strani po meri, na primer AccountsCustomPage |
Ustvarjanje URL-ja programa za platno
Uporabite buildCanvasAppUrlFromEnv() iz kompleta orodij za izdelavo URL-ja iz posameznih delov, če je to potrebno:
import { buildCanvasAppUrlFromEnv } from 'power-platform-playwright-toolkit';
const url = buildCanvasAppUrlFromEnv();
// Reads CANVAS_APP_URL from environment
Ali pa ga izrecno nastavite v .env:
CANVAS_APP_URL=https://apps.powerapps.com/play/e/default-<tenant-id>/a/<app-id>?tenantId=<tenant-id>
Pridobite URL aplikacije, ki temelji na modelu
Upoštevajte ta navodila, da poiščete pravilen URL za aplikacijo, ki temelji na modelu.
- Odprite aplikacijo, ki temelji na modelu, v načinu predvajanja.
- Kopirajte URL iz naslovne vrstice brskalnika.
- Odstranite parametre poizvedbe,
appid=<guid>potem ko so določeni za sejo.
MODEL_DRIVEN_APP_URL=https://<org>.crm.dynamics.com/main.aspx?appid=<app-guid>
Spremenljivke stanja shrambe
Komplet orodij izračuna te spremenljivke iz MS_AUTH_EMAIL. Ne nastavite jih neposredno.
| Pot | Description |
|---|---|
.playwright-ms-auth/state-<email>.json |
Power Apps preverjanje pristnosti (preskusi za platno/gen UX) |
.playwright-ms-auth/state-mda-<email>.json |
Dynamics 365 preverjanje pristnosti (preskusi MDA) |
Preglasi imenik stanja shrambe:
MS_AUTH_STORAGE_DIR=../../.auth
Zastavica CI/CD
To zastavico uporabite, če želite prilagoditi preskusno vedenje za okolja z neprekinjeno integracijo.
| Spremenljivka | Default | Description |
|---|---|---|
CI |
false |
Nastavite na true v CI, da omogočite retries: 1, forbidOnlyin strožje časovne omejitve |
Playwright se samodejno CI prebere. Ni vam ga treba nastaviti v – cevovodnih .env okoljih, ki jih nastavite po konvenciji.
Vzorčna datoteka .env
Te primere uporabite kot izhodišče za lokalno .env datoteko.
# 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 preverjanje pristnosti potrdila:
# 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/...
Varnostne opombe
Upoštevajte te postopke, da ohranite poverilnice in podatke seje varne.
- Nikoli ne uveljavi
.envdatotek v nadzor vira. V.gitignorerepo jih izključuje. - Nikoli ne uveljavi
.playwright-ms-auth/datotek stanja. Vsebujejo žetone seje. - V CI/CD nastavite vse skrivnosti prek skrivnostne shrambe cevovoda, ne pa sproščene v YAML- ju.