Referência de variáveis do ambiente

Esta referência de variáveis de ambiente cobre todas as definições de configuração para amostras do Power Platform Playwright. Para desenvolvimento local, defina estas variáveis em packages/e2e-tests/.env. No CI/CD, define-os como segredos ou variáveis do pipeline. Para instruções específicas do pipeline, veja integração CI/CD.

Variáveis de autenticação

Estas variáveis controlam como o framework de testes se autentica em relação aos serviços Power Platform.

Variable	Obrigatório	Descrição
`MS_AUTH_EMAIL`	Sim	Endereço de email da conta de utilizador do teste
`MS_AUTH_CREDENTIAL_TYPE`	Sim	Método de autenticação: `password` ou `certificate`
`MS_USER_PASSWORD`	Se `credential_type=password`	Palavra-passe para o utilizador de teste
`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`	Caminho relativo para o `.pfx` ficheiro de certificado
`MS_AUTH_CERTIFICATE_PASSWORD`	No	Palavra-passe do `.pfx` certificado (se estiver protegida)

Azure Key Vault variáveis

Obrigató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`	Microsoft Entra tenant ID
`AZURE_CLIENT_ID`	(Opcional) ID do cliente principal de serviço para identidade federada

Variáveis URL da aplicação

Estas variáveis especificam os URLs das aplicações em teste.

Variable	Obrigatório	Descrição
`CANVAS_APP_URL`	Para testes de tela	URL completo do modo de jogo da sua aplicação canvas, incluindo `?tenantId=<id>`
`MODEL_DRIVEN_APP_URL`	Para testes de aplicações orientados por modelos	URL completo da sua aplicação orientada a modelos (`/main.aspx?appid=<id>`)
`CUSTOM_PAGE_NAME`	Para testes de páginas personalizadas	Nome de exibição do item do sitemap da página personalizada, como `AccountsCustomPage`

Construir o URL da aplicação Canvas

Use buildCanvasAppUrlFromEnv() a partir do toolkit para construir o URL a partir de partes individuais, se necessário:

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

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

Ou definir explicitamente em .env:

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

Obtenha o URL da aplicação orientada a modelos

Siga estes passos para encontrar o URL correto para a sua aplicação orientada a modelos.

Abre a aplicação orientada a modelos no modo de reprodução.
Copie a URL da barra de endereços do navegador.
Remover parâmetros de consulta depois appid=<guid> disso são 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 estas variáveis a partir de MS_AUTH_EMAIL. Não os definas diretamente.

Path	Descrição
`.playwright-ms-auth/state-<email>.json`	Estado de autenticação do Power Apps (testes Canvas/Gen UX)
`.playwright-ms-auth/state-mda-<email>.json`	Estado de autenticação Dynamics 365 (testes MDA)

Sobrepor o diretório de estado de armazenamento:

MS_AUTH_STORAGE_DIR=../../.auth

Flag CI/CD

Use este sinalizador para ajustar o comportamento dos testes em ambientes de integração contínua.

Variable	Predefinição	Descrição
`CI`	`false`	Definir em `true` CI para permitir `retries: 1`, `forbidOnly`, e tempos de espera mais rigorosos

O dramaturgo lê CI automaticamente. Não precisas de o definir — .env os ambientes de pipeline definem-no por convenção.

Ficheiro .env de exemplo

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

Observações sobre segurança

Siga estas práticas para manter as credenciais e os dados das sessões seguros.

Nunca comprometas .env ficheiros no controlo de versão. O .gitignore no repositório exclui-os.
Nunca comprometas .playwright-ms-auth/ ficheiros de estado. Contêm tokens de sessão.
No CI/CD, defina todos os segredos através do armazenamento secreto do pipeline, não no YAML check-in.

Partilhar via