Partilhar via

Testar aplicações de canvas com o Test Engine (preview)

Nota

As funcionalidades de pré-visualização não se destinam a utilização em produção e podem ter funcionalidades restritas. Estas caraterísticas estão disponíveis antes do lançamento oficial, para que os clientes possam ter acesso antecipado e enviar comentários.

O teste de aplicativos de tela com o Test Engine requer as seguintes etapas:

  1. Criar um plano de teste
  2. Configurar o utilizador
  3. Executar o teste
  4. Ver os resultados

Criar 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 ficheiro yaml usando o esquema de plano de teste explicado no formato YAML do Power Apps Test Engine (visualização).

Ao escolher a criação de seu próprio plano de teste, você pode aproveitar os seguintes recursos:

  • Funções Power Fx adicionais: use as ações Power Fx registadas extra para interagir com os componentes da estrutura de componentes do Power Apps (PCF), aprimorando as capacidades dos seus planos de teste.
  • Definir estruturas e funções de dados personalizadas: use UDTs (User Defined Types) e UDFs (User Defined Functions) para criar etapas de teste reutilizáveis e sustentáveis.

Sugestão

Analise os planos de exemplo disponíveis no repositório GitHub.

Baixar 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 utilizador com seu aplicativo. Este método é útil para criar casos de teste básicos sem escrever qualquer código. No entanto, 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 Download suite 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 ecrã 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 ecrã do botão individual de descarga da suíte de testes do Test Studio

  • Certifique-se de atualizar o arquivo de configuração e as definições de utilizador se estiver a usar um locatário ou ambiente diferente para este aplicativo.

Configurar o seu utilizador

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

Método Descrição
Estado de armazenamento Armazenar localmente o estado do utilizador autenticado no perfil do utilizador usando a Microsoft Windows API de Proteção de Dados
Dataverse Armazene o estado do utilizador autenticado dentro do Dataverse usando a tua própria chave gerida pelo cliente criptografada com um certificado X.509 usando ASP.NET Core Data Protection

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 de plano de teste contém referências às variáveis de ambiente usadas para a persona do usuário. Por exemplo, o seguinte trecho de YAML indica que as variáveis de user1Email ambiente são usadas:

environmentVariables:
  users:
    - personaName: User1
      emailKey: user1Email

Veja Usuários para obter mais informações.

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

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

Nota

A senha do utilizador não é mais necessária em uma variável de ambiente. Analise a autenticação para obter as opções suportadas.

Executar o teste

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

Parâmetros necessários

Você precisa fornecer as seguintes informações:

  • --test-plan-file: Caminho para o ficheiro de plano de teste
  • --tenant: O seu ID de inquilino
  • --environment-id: Seu ID de ambiente

Exemplo de comando

Aqui está um exemplo de execução de um teste para um aplicativo de tela:

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 os aliases de parâmetro mais curtos:

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

Integração com o Dataverse

Para habilitar a integração do Dataverse com os seus testes de aplicações de tela, pode adicionar o parâmetro enableDataverseFunctions nas suas definições de teste.

testSettings:
  extensionModules:
    enable: true
    parameters:
      enableDataverseFunctions: true

Quando se habilita a integração do Dataverse, é necessário abrir a CLI do Azure com um utilizador ou entidade de serviço que tenha direitos sobre o ambiente do Dataverse. Você pode usar o comando az login . Para obter mais informações: inicie sessão na CLI do Azure.

A Dataverse URL da API usada para integração é obtida do nome de domínio do host do parâmetro pac test run--domain ou definindo uma variável de ambiente do PowerShell nomeada DATAVERSE_URL.

Ver os resultados

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

  • Last updated on