Referencia de variables de entorno

Esta referencia de variables de entorno abarca todas las opciones de configuración de los ejemplos de Power Platform Playwright. Para el desarrollo local, establezca estas variables en packages/e2e-tests/.env. En CI/CD, establézcalos como secretos de canalización o variables. Para obtener instrucciones específicas de la canalización, consulte Integración de CI/CD.

Variables de autenticación

Estas variables controlan cómo se autentica el marco de pruebas en los servicios de Power Platform.

Variable	Obligatorio	Descripción
`MS_AUTH_EMAIL`	Sí	Dirección de correo electrónico de la cuenta de usuario de prueba
`MS_AUTH_CREDENTIAL_TYPE`	Sí	Método de autenticación: `password` o `certificate`
`MS_USER_PASSWORD`	Si `credential_type=password`	Contraseña del usuario de prueba
`MS_AUTH_CREDENTIAL_PROVIDER`	Si `credential_type=certificate`	Origen del certificado: `local-file` o `azure-keyvault`
`MS_AUTH_LOCAL_FILE_PATH`	Si `provider=local-file`	Ruta de acceso relativa al archivo de `.pfx` certificado
`MS_AUTH_CERTIFICATE_PASSWORD`	No	Contraseña del `.pfx` certificado (si está protegido)

variables de Azure Key Vault

Obligatorio cuando MS_AUTH_CREDENTIAL_PROVIDER=azure-keyvault:

Variable	Descripción
`AZURE_KEYVAULT_URL`	Key Vault URL, por ejemplo, `https://<vault-name>.vault.azure.net/`
`AZURE_CERTIFICATE_NAME`	Nombre del certificado almacenado en Key Vault
`AZURE_TENANT_ID`	id. de inquilino de Microsoft Entra
`AZURE_CLIENT_ID`	(Opcional) Identificador de cliente de entidad de servicio para la identidad federada

Variables de dirección URL de la aplicación

Estas variables especifican las direcciones URL de las aplicaciones en prueba.

Variable	Obligatorio	Descripción
`CANVAS_APP_URL`	Para las pruebas de lienzo	Dirección URL del modo de reproducción completa de la aplicación de lienzo, incluido `?tenantId=<id>`
`MODEL_DRIVEN_APP_URL`	Para las pruebas de aplicaciones controladas por modelos	Dirección URL completa de la aplicación controlada por modelos (`/main.aspx?appid=<id>`)
`CUSTOM_PAGE_NAME`	Para pruebas de página personalizadas	Nombre para mostrar del elemento de mapa del sitio de la página personalizada, como `AccountsCustomPage`

Compilación de la dirección URL de la aplicación de lienzo

Use buildCanvasAppUrlFromEnv() desde el kit de herramientas para construir la dirección URL a partir de elementos individuales si es necesario:

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

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

O establézcalo explícitamente en .env:

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

Obtención de la dirección URL de la aplicación controlada por modelos

Siga estos pasos para buscar la dirección URL correcta de la aplicación controlada por modelos.

Abra la aplicación controlada por modelos en modo de reproducción.
Copie la dirección URL de la barra de direcciones del explorador.
Quite los parámetros de consulta después appid=<guid> de que sean específicos de la sesión.

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

Variables de estado de almacenamiento

El kit de herramientas calcula estas variables desde MS_AUTH_EMAIL. No los establezcas directamente.

Camino	Descripción
`.playwright-ms-auth/state-<email>.json`	Power Apps estado de autenticación (pruebas de experiencia de usuario de lienzo/gen)
`.playwright-ms-auth/state-mda-<email>.json`	Dynamics 365 estado de autenticación (pruebas de MDA)

Invalide el directorio de estado de almacenamiento:

MS_AUTH_STORAGE_DIR=../../.auth

Marca de CI/CD

Use esta marca para ajustar el comportamiento de prueba para entornos de integración continua.

Variable	Predeterminado	Descripción
`CI`	`false`	`true` Establézcalo en en CI para habilitar `retries: 1`los tiempos de espera más `forbidOnly`estrictos.

Playwright lee CI automáticamente. No es necesario establecerlo en .env : los entornos de canalización lo establecen por convención.

Archivo .env de ejemplo

Use estos ejemplos como punto de partida para el archivo 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 la autenticación de certificados:

# 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 seguridad

Siga estos procedimientos para proteger las credenciales y los datos de sesión.

Nunca confirme .env archivos en el control de código fuente. El .gitignore elemento del repositorio los excluye.
Nunca confirme .playwright-ms-auth/ los archivos de estado. Contienen tokens de sesión.
En CI/CD, establezca todos los secretos a través del almacén de secretos de la canalización, no en YAML protegido.