Referencia de variables ambientais

Esta referencia de variables de ambiente cobre todas as configuracións para mostras de Power Platform Playwright. Para o desenvolvemento local, establece estas variables en packages/e2e-tests/.env. En CI/CD, configúraas como segredos ou variables do pipeline. Para instrucións específicas do pipeline, véxase integración CI/CD.

Variables de autenticación

Estas variables controlan como o marco de proba se autentica fronte aos servizos de Power Platform.

Variable	Necesario	Descripción
`MS_AUTH_EMAIL`	Si	Enderezo de correo electrónico da conta de usuario da proba
`MS_AUTH_CREDENTIAL_TYPE`	Si	Método de autenticación: `password` ou `certificate`
`MS_USER_PASSWORD`	Se `credential_type=password`	Contrasinal para o usuario de proba
`MS_AUTH_CREDENTIAL_PROVIDER`	Se `credential_type=certificate`	Fonte do certificado: `local-file` ou `azure-keyvault`
`MS_AUTH_LOCAL_FILE_PATH`	Se `provider=local-file`	Ruta relativa ao `.pfx` ficheiro do certificado
`MS_AUTH_CERTIFICATE_PASSWORD`	Non	Contrasinal do `.pfx` certificado (se está protexido)

Azure Key Vault variables

Requirido cando MS_AUTH_CREDENTIAL_PROVIDER=azure-keyvault:

Variable	Descripción
`AZURE_KEYVAULT_URL`	Key Vault URL, por exemplo, `https://<vault-name>.vault.azure.net/`
`AZURE_CERTIFICATE_NAME`	Nome do certificado almacenado en Key Vault
`AZURE_TENANT_ID`	Microsoft Entra tenant ID
`AZURE_CLIENT_ID`	(Opcional) ID de cliente principal de servizo para identidade federada

Variables URL da aplicación

Estas variables especifican as URLs das aplicacións en probar.

Variable	Necesario	Descripción
`CANVAS_APP_URL`	Para probas de lenzo	URL completo do modo de xogo da túa aplicación canvas, incluíndo `?tenantId=<id>`
`MODEL_DRIVEN_APP_URL`	Para probas de aplicacións baseadas en modelos	URL completo da túa aplicación baseada en modelos (`/main.aspx?appid=<id>`)
`CUSTOM_PAGE_NAME`	Para probas de páxinas personalizadas	Nome de visualización do elemento do mapa do sitio da páxina personalizada, como `AccountsCustomPage`

Compilar a URL da aplicación Canvas

Usa buildCanvasAppUrlFromEnv() desde o conxunto de ferramentas para construír a URL a partir de partes individuais se é necesario:

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

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

Ou poñelo explicitamente en .env:

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

Obtén a URL da aplicación guiada por modelos

Segue estes pasos para atopar a URL correcta para a túa aplicación baseada en modelos.

Abre a aplicación baseada en modelos en modo xogo.
Copia a URL da barra de enderezos do navegador.
Eliminar os parámetros da consulta despois appid=<guid> de que sexan específicos da sesión.

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

Variables de estado de almacenamento

O conxunto de ferramentas calcula estas variables a partir de MS_AUTH_EMAIL. Non as configures directamente.

Camiño	Descripción
`.playwright-ms-auth/state-<email>.json`	Estado de autenticación de Power Apps (probas de canvas/Gen UX)
`.playwright-ms-auth/state-mda-<email>.json`	Estado de autenticación de Dynamics 365 (probas MDA)

Anular o directorio de estado de almacenamento:

MS_AUTH_STORAGE_DIR=../../.auth

Bandeira CI/CD

Usa esta bandeira para axustar o comportamento das probas en contornos de integración continua.

Variable	Default	Descripción
`CI`	`false`	Configúrase en `true` CI para habilitar `retries: 1`, `forbidOnly`, e tempos límite máis estritos

O dramaturgo le CI automaticamente. Non necesitas configuralo .env — os ambientes de pipeline configúrono por convención.

Ficheiro .env de exemplo

Usa estes exemplos como punto de partida para o teu ficheiro 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

Para a autenticación do certificado:

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

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

Notas de seguridade

Segue estas prácticas para manter seguras as credenciais e os datos das sesións.

Nunca comprometas .env ficheiros no control de versións. O .gitignore no repositorio exclúeos.
Nunca commitas .playwright-ms-auth/ ficheiros de estado. Conteñen tokens de sesión.
En CI/CD, establece todos os segredos a través do almacén secreto do pipeline, non en YAML rexistrado.