Referència de variables ambientals

Aquesta referència de variables d'entorn cobreix tots els ajustos de configuració per a mostres de Power Platform Playwright. Per al desenvolupament local, estableix aquestes variables a packages/e2e-tests/.env. En CI/CD, configura'ls com a secrets o variables de pipeline. Per a instruccions específiques de la canonada, vegeu integració CI/CD.

Variables d'autenticació

Aquestes variables controlen com el marc de proves s'autentica contra els serveis de Power Platform.

Variable	Necessari	Descripció
`MS_AUTH_EMAIL`	Sí	Adreça de correu electrònic del compte d'usuari de prova
`MS_AUTH_CREDENTIAL_TYPE`	Sí	Mètode d'autenticació: `password` o `certificate`
`MS_USER_PASSWORD`	Si `credential_type=password`	Contrasenya per a l'usuari de prova
`MS_AUTH_CREDENTIAL_PROVIDER`	Si `credential_type=certificate`	Font del certificat: `local-file` o `azure-keyvault`
`MS_AUTH_LOCAL_FILE_PATH`	Si `provider=local-file`	Ruta relativa al `.pfx` fitxer del certificat
`MS_AUTH_CERTIFICATE_PASSWORD`	No	Contrasenya del `.pfx` certificat (si està protegit)

Azure Key Vault variables

Obligatòria quan MS_AUTH_CREDENTIAL_PROVIDER=azure-keyvault:

Variable	Descripció
`AZURE_KEYVAULT_URL`	Key Vault URL, per exemple, `https://<vault-name>.vault.azure.net/`
`AZURE_CERTIFICATE_NAME`	Nom del certificat emmagatzemat a Key Vault
`AZURE_TENANT_ID`	Microsoft Entra tenant ID
`AZURE_CLIENT_ID`	(Opcional) ID de client principal de servei per a identitat federada

Variables d'URL de l'aplicació

Aquestes variables especifiquen les URL de les aplicacions sota prova.

Variable	Necessari	Descripció
`CANVAS_APP_URL`	Per a proves de llenç	URL completa del mode de joc de la teva aplicació Canvas, incloent-hi `?tenantId=<id>`
`MODEL_DRIVEN_APP_URL`	Per a proves d'aplicacions basades en models	URL completa de la teva aplicació basada en models (`/main.aspx?appid=<id>`)
`CUSTOM_PAGE_NAME`	Per a proves de pàgines personalitzades	Nom de visualització de l'element personalitzat del mapa del lloc, com ara `AccountsCustomPage`

Construeix la URL de l'aplicació Canvas

Utilitza buildCanvasAppUrlFromEnv() el conjunt d'eines per construir la URL a partir de parts individuals si cal:

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

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

O posar-ho explícitament en .env:

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

Obteniu la URL de l'aplicació basada en models

Segueix aquests passos per trobar l'URL correcta per a la teva aplicació basada en models.

Obre l'aplicació basada en models en mode de joc.
Copia l'URL de la barra d'adreces del navegador.
Eliminar els paràmetres de consulta després appid=<guid> són específics de la sessió.

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

Variables d'estat d'emmagatzematge

El conjunt d'eines calcula aquestes variables a partir de MS_AUTH_EMAIL. No els configuris directament.

Camí	Descripció
`.playwright-ms-auth/state-<email>.json`	Estat d'autenticació de Power Apps (tests de Canvas/Gen UX)
`.playwright-ms-auth/state-mda-<email>.json`	Dynamics 365 estat d'autenticació (proves MDA)

Sobreescriu el directori d'estat d'emmagatzematge:

MS_AUTH_STORAGE_DIR=../../.auth

Bandera CI/CD

Utilitza aquesta bandera per ajustar el comportament de prova en entorns d'integració contínua.

Variable	Valor per defecte	Descripció
`CI`	`false`	Estableix en `true` CI per activar `retries: 1`, `forbidOnly`, i temps d'espera més estricte

El dramaturg llegeix CI automàticament. No cal que ho configuris — .env els entorns de pipeline ho configuren per convenció.

Fitxer .env d'exemple

Utilitza aquests exemples com a punt de partida per al teu fitxer 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

Per a l'autenticació del certificat:

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

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

Notes de seguretat

Segueix aquestes pràctiques per mantenir segures les credencials i les dades de sessió.

Mai comprometis .env fitxers al control de versió. El .gitignore que està al repo els exclou.
Mai confirmis .playwright-ms-auth/ fitxers d'estat. Contenen tokens de sessió.
A CI/CD, configura tots els secrets a través de la memòria secreta de la pipeline, no en YAML registrat.