Poznámka
Na prístup k tejto stránke sa vyžaduje oprávnenie. Môžete sa skúsiť prihlásiť alebo zmeniť adresáre.
Na prístup k tejto stránke sa vyžaduje oprávnenie. Môžete skúsiť zmeniť adresáre.
Tento odkaz na premenné prostredia sa vzťahuje na všetky nastavenia konfigurácie pre ukážky platformy Power Platform Playwright. Pre lokálny vývoj nastavte tieto premenné v packages/e2e-tests/.env. V CI/CD ich nastavte ako tajné kódy kanálov alebo premenné. Pokyny špecifické pre kanál nájdete v téme Integrácia CI/CD.
Premenné overovania
Tieto premenné určujú, ako sa testovacia architektúra overuje v službách Power Platform.
| Premenná | Required | Description |
|---|---|---|
MS_AUTH_EMAIL |
Áno | E-mailová adresa testovacieho používateľského konta |
MS_AUTH_CREDENTIAL_TYPE |
Áno | Metóda overovania: password alebo certificate |
MS_USER_PASSWORD |
Ak credential_type=password |
Heslo testovacieho používateľa |
MS_AUTH_CREDENTIAL_PROVIDER |
Ak credential_type=certificate |
Zdroj certifikátu: local-file alebo azure-keyvault |
MS_AUTH_LOCAL_FILE_PATH |
Ak provider=local-file |
Relatívna cesta k súboru certifikátu .pfx |
MS_AUTH_CERTIFICATE_PASSWORD |
Nie | Heslo certifikátu .pfx (v prípade ochrany) |
Azure Key Vault premenné
Povinné, keď MS_AUTH_CREDENTIAL_PROVIDER=azure-keyvault:
| Premenná | Description |
|---|---|
AZURE_KEYVAULT_URL |
URL Key Vault napríklad https://<vault-name>.vault.azure.net/ |
AZURE_CERTIFICATE_NAME |
Názov certifikátu uloženého v službe Key Vault |
AZURE_TENANT_ID |
Microsoft Entra ID nájomníka |
AZURE_CLIENT_ID |
(Voliteľné) ID klienta objektu služby pre federované identity |
Premenné URL adresy aplikácie
Tieto premenné špecifikujú URL adresy aplikácií, ktoré sú v teste.
| Premenná | Required | Description |
|---|---|---|
CANVAS_APP_URL |
Pre testy plátna | ÚPLNÁ URL adresa v režime prehrávania vašej plátnovej aplikácie vrátane ?tenantId=<id> |
MODEL_DRIVEN_APP_URL |
Na testovanie aplikácie riadenej modelom | Úplná URL adresa modelom riadenej aplikácie (/main.aspx?appid=<id>) |
CUSTOM_PAGE_NAME |
Na vlastné testy stránky | Zobrazovaný názov položky vlastnej stránky mapy lokality, napríklad AccountsCustomPage |
Vytvorenie URL adresy plátnovej aplikácie
URL buildCanvasAppUrlFromEnv() adresu môžete v prípade potreby vytvoriť z súpravy nástrojov:
import { buildCanvasAppUrlFromEnv } from 'power-platform-playwright-toolkit';
const url = buildCanvasAppUrlFromEnv();
// Reads CANVAS_APP_URL from environment
Alebo ho explicitne nastavte v :.env
CANVAS_APP_URL=https://apps.powerapps.com/play/e/default-<tenant-id>/a/<app-id>?tenantId=<tenant-id>
Získanie URL adresy aplikácie riadenej modelom
Ak chcete nájsť správnu URL adresu svojej modelom riadenej aplikácie, postupujte podľa týchto krokov.
- Otvorte modelom riadenú aplikáciu v režime prehrávania.
- Skopírujte URL adresu z panela s adresou prehliadača.
- Potom odstráňte parametre
appid=<guid>dotazu, ktoré sú špecifické pre konkrétnu reláciu.
MODEL_DRIVEN_APP_URL=https://<org>.crm.dynamics.com/main.aspx?appid=<app-guid>
Premenné stavu úložiska
Súprava nástrojov vypočíta tieto premenné z lokality MS_AUTH_EMAIL. Nenastavovať priamo.
| Cesta | Description |
|---|---|
.playwright-ms-auth/state-<email>.json |
Power Apps stav overenia (testy plátna/gen.ux) |
.playwright-ms-auth/state-mda-<email>.json |
Dynamics 365 stav overenia (testy MDA) |
Prepísanie adresára stavu úložiska:
MS_AUTH_STORAGE_DIR=../../.auth
Príznak CI/CD
Pomocou tohto príznaku upravíte testovacie správanie pre prostredia priebežnej integrácie.
| Premenná | Predvolené | Description |
|---|---|---|
CI |
false |
Nastavenie na true hodnotu v CI na povolenie retries: 1, forbidOnlya prísnejšie časové limity |
Knižnica Playwright číta CI automaticky. Nie je potrebné nastavovať ho v .env prostrediach pre kanály, ktoré ho nastavujú podľa konvencie.
Vzorový súbor .env
Tieto príklady použite ako východiskový bod pre lokálny .env súbor.
# 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
Pre overenie certifikátu:
# 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/...
Pre 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/...
Poznámky k zabezpečeniu
Ak chcete zachovať bezpečnosť prihlasovacích údajov a údajov relácie, postupujte podľa týchto postupov.
- Nikdy neodošlite
.envsúbory do zdrojového ovládania. Funkcia.gitignorev odkladacom priestore ich vylúči. - Nikdy neodošlite
.playwright-ms-auth/súbory stavu. Obsahujú tokeny relácie. - V CI/CD nastavte všetky tajomstvá prostredníctvom ukladacieho priestoru tajných kódov kanála, nie v začiarkovanom kóde YAML.