Referência de variáveis de ambiente

Essa referência de variáveis de ambiente abrange todas as configurações de exemplos do Power Platform Playwright. Para desenvolvimento local, defina essas variáveis em packages/e2e-tests/.env. Em CI/CD, defina-os como segredos ou variáveis de pipeline. Para obter instruções específicas do pipeline, consulte a integração de CI/CD.

Variáveis de autenticação

Essas variáveis controlam como a estrutura de teste se autentica nos serviços do Power Platform.

Variable	Obrigatório	Descrição
`MS_AUTH_EMAIL`	Sim	Endereço de email da conta de usuário de teste
`MS_AUTH_CREDENTIAL_TYPE`	Sim	Método de autenticação: `password` ou `certificate`
`MS_USER_PASSWORD`	Se `credential_type=password`	Senha para o usuário de teste
`MS_AUTH_CREDENTIAL_PROVIDER`	Se `credential_type=certificate`	Origem do certificado: `local-file` ou `azure-keyvault`
`MS_AUTH_LOCAL_FILE_PATH`	Se `provider=local-file`	Caminho relativo para o arquivo de `.pfx` certificado
`MS_AUTH_CERTIFICATE_PASSWORD`	No	Senha do `.pfx` certificado (se protegido)

variáveis Azure Key Vault

Necessário quando MS_AUTH_CREDENTIAL_PROVIDER=azure-keyvault:

Variable	Descrição
`AZURE_KEYVAULT_URL`	Key Vault URL, por exemplo, `https://<vault-name>.vault.azure.net/`
`AZURE_CERTIFICATE_NAME`	Nome do certificado armazenado no Key Vault
`AZURE_TENANT_ID`	ID do locatário Microsoft Entra
`AZURE_CLIENT_ID`	(Opcional) ID do cliente da entidade de serviço para identidade federada

Variáveis de URL do aplicativo

Essas variáveis especificam as URLs dos aplicativos em teste.

Variable	Obrigatório	Descrição
`CANVAS_APP_URL`	Para testes de tela	URL completa do modo de reprodução do aplicativo de tela, incluindo `?tenantId=<id>`
`MODEL_DRIVEN_APP_URL`	Para testes de aplicativo controlados por modelo	URL completa do seu aplicativo controlado por modelos (`/main.aspx?appid=<id>`)
`CUSTOM_PAGE_NAME`	Para testes de página personalizados	Nome de exibição do item de sitemap de página personalizado, como `AccountsCustomPage`

Criar a URL do aplicativo de tela

Use buildCanvasAppUrlFromEnv() do kit de ferramentas para construir a URL de partes individuais, se necessário:

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

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

Ou defina-o explicitamente em .env:

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

Obter a URL do aplicativo orientada por modelos

Siga estas etapas para localizar a URL correta para seu aplicativo controlado por modelos.

Abra o aplicativo controlado por modelos no modo de reprodução.
Copie a URL da barra de endereços do navegador.
Remova os parâmetros de consulta depois appid=<guid> que eles forem específicos da sessão.

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

Variáveis de estado de armazenamento

O kit de ferramentas calcula essas variáveis de MS_AUTH_EMAIL. Não os defina diretamente.

Caminho	Descrição
`.playwright-ms-auth/state-<email>.json`	Power Apps estado de autenticação (testes de UX de tela/geração)
`.playwright-ms-auth/state-mda-<email>.json`	Dynamics 365 estado de autenticação (testes de MDA)

Substitua o diretório de estado de armazenamento:

MS_AUTH_STORAGE_DIR=../../.auth

Sinalizador de CI/CD

Use esse sinalizador para ajustar o comportamento de teste para ambientes de integração contínua.

Variable	Default	Descrição
`CI`	`false`	Definir como `true` em CI para habilitar `retries: 1`, `forbidOnly`e tempos limite mais estritos

O dramaturgo lê CI automaticamente. Você não precisa defini-lo em .env ambientes de pipeline definidos por convenção.

Arquivo .env de exemplo

Use esses exemplos como ponto de partida para o arquivo 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 autenticação de 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/...

Observações sobre segurança

Siga estas práticas para manter as credenciais e os dados de sessão seguros.

Nunca confirme .env arquivos no controle do código-fonte. O .gitignore repositório os exclui.
Nunca confirme arquivos de .playwright-ms-auth/ estado. Eles contêm tokens de sessão.
Em CI/CD, defina todos os segredos por meio do repositório de segredos do pipeline, não no YAML de check-in.