Compartilhar via

Testar aplicativos Canvas com o Test Engine (visualização)

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 aplicativos Canvas 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

Os planos de teste são definidos usando o formato YAML . Você pode criar seu próprio plano de teste ou baixar testes gravados do Test Studio.

Crie seu próprio 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).

Ao escolher criar seu próprio plano de teste, você pode aproveitar os seguintes recursos:

  • Funções Power Fx adicionais: use as ações extras registradas Power Fx para interagir com os componentes do framework de componentes (PCF), aprimorando os recursos dos seus planos de teste. Power Apps
  • Defina estruturas de dados e funções personalizadas: use tipos definidos pelo usuário (UDTs) e funções definidas pelo usuário (UDFs) para criar etapas de teste reutilizáveis e sustentáveis.

Dica

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

Baixe os testes gravados do Test Studio

O download de testes gravados do Test Studio permite a captura e reprodução rápidas das interações do usuário com seu aplicativo. Este método é útil para criar casos de teste básicos sem escrever nenhum código. No entanto, ele tem limitações em termos de flexibilidade e capacidade de lidar com cenários complexos.

Se você tiver testes gravados no Test Studio, poderá baixá-los do Test Studio para reutilizá-los no Test Engine.

  • Use o botão Baixar pacote no Test Studio para baixar o plano de teste. Escolha o conjunto de testes para baixar se você tiver vários conjuntos de testes.

    Captura de tela do botão de download do conjunto de testes do Test Studio

  • Como alternativa, use o botão Download disponível em cada conjunto de testes.

    Captura de tela do botão individual de download do conjunto de testes do Test Studio

  • Certifique-se de atualizar o arquivo de configuração e as configurações do usuário se estiver usando um locatário ou ambiente diferente para este aplicativo.

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 quais variáveis de ambiente são 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"

Observação

A senha do usuário não é mais necessária em uma variável de ambiente. Revise a autenticação para opções suportadas.

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

Comando de exemplo

Veja um exemplo de execução de um teste para um aplicativo Canvas:

pac test run `
   --provider canvas `
   --test-plan-file your-testplan.te.yaml `
   --tenant your-tenantid-guid-value `
   --environment-id your-environmentid-guid-value

Você também pode usar aliases de parâmetros mais curtos:

pac test run `
   -p canvas `
   -test your-testplan.te.yaml `
   -t your-tenantid-guid-value `
   -env your-environmentid-guid-value

Integração do Dataverse

Para habilitar a integração com os testes do seu aplicativo Canvas, você pode adicionar o parâmetro nas configurações do seu teste: Dataverse enableDataverseFunctions

testSettings:
  extensionModules:
    enable: true
    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: Faça login com o Azure CLI.

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