Poznámka:
Přístup k této stránce vyžaduje autorizaci. Můžete se zkusit přihlásit nebo změnit adresáře.
Přístup k této stránce vyžaduje autorizaci. Můžete zkusit změnit adresáře.
Tyto referenční informace o proměnných prostředí se týkají všech nastavení konfigurace pro ukázky Playwright pro Power Platform. Pro místní vývoj nastavte tyto proměnné v packages/e2e-tests/.env. V CI/CD je nastavte jako tajné kódy kanálu nebo proměnné. Pokyny specifické pro kanál najdete v tématu Integrace CI/CD.
Proměnné ověřování
Tyto proměnné řídí, jak se testovací architektura ověřuje ve službách Power Platform.
| Variable | Povinné | Description |
|---|---|---|
MS_AUTH_EMAIL |
Ano | E-mailová adresa testovacího uživatelského účtu |
MS_AUTH_CREDENTIAL_TYPE |
Ano | Metoda ověřování: password nebo certificate |
MS_USER_PASSWORD |
Pokud credential_type=password |
Heslo pro testovacího uživatele |
MS_AUTH_CREDENTIAL_PROVIDER |
Pokud credential_type=certificate |
Zdroj certifikátu: local-file nebo azure-keyvault |
MS_AUTH_LOCAL_FILE_PATH |
Pokud provider=local-file |
Relativní cesta k .pfx souboru certifikátu |
MS_AUTH_CERTIFICATE_PASSWORD |
Ne | Heslo pro .pfx certifikát (pokud je chráněné) |
proměnné Azure Key Vault
Požadováno v případě MS_AUTH_CREDENTIAL_PROVIDER=azure-keyvault:
| Variable | Description |
|---|---|
AZURE_KEYVAULT_URL |
Key Vault adresa URL, například https://<vault-name>.vault.azure.net/ |
AZURE_CERTIFICATE_NAME |
Název certifikátu uloženého v Key Vault |
AZURE_TENANT_ID |
Identifikátor tenanta Microsoft Entra |
AZURE_CLIENT_ID |
(Volitelné) ID klienta instančního objektu pro federovanou identitu |
Proměnné adresy URL aplikace
Tyto proměnné určují adresy URL aplikací, které se testují.
| Variable | Povinné | Description |
|---|---|---|
CANVAS_APP_URL |
Pro testy plátna | Úplná adresa URL v režimu přehrávání aplikace plátna, včetně ?tenantId=<id> |
MODEL_DRIVEN_APP_URL |
Pro testy modelem řízených aplikací | Úplná adresa URL modelem řízené aplikace (/main.aspx?appid=<id>) |
CUSTOM_PAGE_NAME |
Pro vlastní testy stránek | Zobrazovaný název vlastní položky mapy webu stránky, například AccountsCustomPage |
Vytvoření adresy URL aplikace plátna
V případě potřeby pomocí buildCanvasAppUrlFromEnv() sady nástrojů vytvořte adresu URL z jednotlivých částí:
import { buildCanvasAppUrlFromEnv } from 'power-platform-playwright-toolkit';
const url = buildCanvasAppUrlFromEnv();
// Reads CANVAS_APP_URL from environment
Nebo ho explicitně nastavte v .env:
CANVAS_APP_URL=https://apps.powerapps.com/play/e/default-<tenant-id>/a/<app-id>?tenantId=<tenant-id>
Získání adresy URL modelem řízené aplikace
Pomocí těchto kroků vyhledejte správnou adresu URL pro modelem řízenou aplikaci.
- Otevřete modelem řízenou aplikaci v režimu přehrávání.
- Zkopírujte adresu URL z adresního řádku prohlížeče.
- Odeberte parametry dotazu, které
appid=<guid>jsou specifické pro relaci.
MODEL_DRIVEN_APP_URL=https://<org>.crm.dynamics.com/main.aspx?appid=<app-guid>
Proměnné stavu úložiště
Sada nástrojů vypočítá tyto proměnné z MS_AUTH_EMAIL. Nenastavujte je přímo.
| Cesta | Description |
|---|---|
.playwright-ms-auth/state-<email>.json |
Power Apps stavu ověřování (testy uživatelského rozhraní plátna/Gen) |
.playwright-ms-auth/state-mda-<email>.json |
Dynamics 365 stavu ověřování (testy MDA) |
Přepsat adresář stavu úložiště:
MS_AUTH_STORAGE_DIR=../../.auth
Příznak CI/CD
Tento příznak použijte k úpravě chování testů pro prostředí kontinuální integrace.
| Variable | Default | Description |
|---|---|---|
CI |
false |
Nastavte v true CI, aby bylo možné povolit retries: 1, forbidOnlya přísnější časové limity |
Playwright čte CI automaticky. Nemusíte ho .env nastavovat – prostředí kanálu je nastavují podle konvence.
Ukázkový soubor .env
Tyto příklady použijte jako výchozí bod místního .env souboru.
# 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
Pro ověřování certifikátů:
# 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/...
Pro 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ámka k zabezpečení
Při zachování přihlašovacích údajů a dat relací postupujte podle těchto postupů.
- Nikdy neschovávejte
.envsoubory do správy zdrojového kódu. V.gitignoreúložišti se vyloučí. - Nikdy neschovávejte
.playwright-ms-auth/soubory stavu. Obsahují tokeny relace. - V CI/CD nastavte všechny tajné kódy prostřednictvím úložiště tajných kódů kanálu, nikoli v vrácení se změnami YAML.