Compartilhar via

Testar aplicativos orientados a modelos com o Test Engine (prévia)

Observação

Os recursos de versão preliminar não foram criados para uso em ambientes de produção e podem ter funcionalidade restrita. Esses recursos são disponibilizados antes de um lançamento oficial para que os clientes possam ter acesso antecipado e forneçam comentários.

Testar seu aplicativo orientado a modelos com o Test Engine requer as seguintes etapas:

  1. Crie um plano de teste
  2. Configure seu usuário
  3. Execute o teste
  4. Ver os resultados

Crie um plano de teste

Crie um arquivo yaml usando o esquema do plano de teste explicado em Power Apps Formato YAML do mecanismo de teste (visualização).

Dica

Revise os planos de amostra disponíveis no repositório do GitHub. ...

Habilitar versão prévia

Atualmente, todos os recursos de teste de extensão de aplicativo orientados a modelos exigem o uso de funções de visualização . Para habilitá-los, adicione Preview à allowPowerFxNamespaces lista em extensionModules do seu testSettings.

Este exemplo mostra como adicionar isto:

testSettings:
  extensionModules:
    enable: true
    allowPowerFxNamespaces:
    - Preview

Configure seu usuário

O Test Engine atualmente tem estes métodos de autenticação:

Method Description
Estado de armazenamento Armazene o estado do usuário autenticado localmente no perfil do usuário usando a API de proteção de dados Microsoft Windows
Dataverse Armazene o estado do usuário autenticado dentro Dataverse usando sua própria chave gerenciada pelo cliente, criptografada com um certificado X.509 usando ASP.NET Proteção de Dados Principais

Não é possível armazenar credenciais de teste em arquivos de plano de teste. Você deve selecionar Storagestate ou Dataverse como o local seguro para armazenar credenciais. O arquivo do plano de teste contém referências às variáveis de ambiente usadas para a persona do usuário. Por exemplo, o seguinte snippet YAML indica que as variáveis de ambiente são usadas: user1Email

environmentVariables:
  users:
    - personaName: User1
      emailKey: user1Email

Veja Usuários para mais informações.

Use o seguinte script do PowerShell para armazenar o nome de usuário em suas variáveis de ambiente.

$env:user1Email = "someone@example.com"

Execute o teste

Use o comando PAC CLI pac test run para executar seu plano de teste.

Parâmetros obrigatórios

Você precisará fornecer as seguintes informações:

  • --test-plan-file: Caminho para o arquivo do seu plano de teste
  • --tenant: Seu ID de inquilino
  • --environment-id: Seu ID de ambiente
  • --domain: URL de domínio da página do aplicativo orientado a modelo a ser testado

Formatos de URL para aplicativos baseados em modelos

Para aplicativos orientados a modelos, o parâmetro varia de acordo com o tipo de página que você está testando. --domain O formato da URL deve especificar o correto pagetype com base no seu cenário de teste:

# For custom pages
pac test run `
   --provider mda `
   --test-plan-file your-testplan.te.yaml `
   --tenant your-tenantid-guid-value `
   --environment-id your-environmentid-guid-value `
   --domain "https://contoso.crm.dynamics.com/main.aspx?appid=00001111-aaaa-2222-bbbb-3333cccc4444&pagetype=custom&name=dev_home_c8017"

# For entity lists (views)
pac test run `
   --provider mda `
   --test-plan-file your-testplan.te.yaml `
   --tenant your-tenantid-guid-value `
   --environment-id your-environmentid-guid-value `
   --domain "https://contoso.crm.dynamics.com/main.aspx?appid=00001111-aaaa-2222-bbbb-3333cccc4444&pagetype=entitylist&etn=account&viewid=5a84c584-df1c-ed11-9db0-000d3a991110"

# For entity records (forms)
pac test run `
   --provider mda `
   --test-plan-file your-testplan.te.yaml `
   --tenant your-tenantid-guid-value `
   --environment-id your-environmentid-guid-value `
   --domain "https://contoso.crm.dynamics.com/main.aspx?appid=00001111-aaaa-2222-bbbb-3333cccc4444&pagetype=entityrecord&etn=account&id=72e0e163-df1c-ed11-9db0-000d3a991110"

Dataverse Integração

Para habilitar Dataverse a integração com seus testes de aplicativo orientados a modelos, adicione o enableDataverseFunctions parâmetro em seu testSettings:

testSettings:
  extensionModules:
    enable: true
    allowPowerFxNamespaces:
    - Preview
    parameters:
      enableDataverseFunctions: true

Ao habilitar a integração, você precisa abrir a CLI do Azure com um usuário ou entidade de serviço que tenha direitos ao ambiente. Dataverse Dataverse Você pode usar o comando: az login Mais informações: Efetuar login com a CLI do Azure.

O Dataverse URL da API usado para integração é obtido do nome de domínio do host do parâmetro de execução do teste pac--domain ou definindo uma variável de ambiente do PowerShell chamada DATAVERSE_URL.

Exibir os resultados

Quando os testes forem concluídos, você poderá visualizar os resultados no arquivo .trx localizado no diretório de saída. Esta pasta contém todas as capturas de tela ou vídeos capturados pelos seus testes quando recordVideo está definido como true no yaml do plano de teste.

  • Last updated on