Formato YAML do Power Apps Test Engine (visualização)

Os testes são definidos no YAML seguindo as mesmas diretrizes do Power Fx. Saiba mais sobre a gramática da fórmula Power Fx YAML.

Exiba a pasta PowerApps-TestEngine/samples para obter exemplos detalhados.

Definições de esquema YAML

testSuite

Usado para definir um teste.

Como identificar a sua aplicação no plano de teste

Você precisa definir um ou appLogicalNameappId para identificar seu aplicativo. O que você usa depende se seu aplicativo está definido dentro de uma solução.

Aplicativos baseados em soluções (recomendado)

Quando você define seus aplicativos dentro de soluções, seus testes permanecem portáteis em todos os ambientes. Defina a appLogicalName propriedade para indicar que o aplicativo é baseado em solução.

Para localizar o nome lógico do aplicativo:

1. Abra a solução que contém a sua aplicação no Power Apps
2. Use o Nome (não Nome para exibição) na lista. O valor do nome inclui o prefixo de personalização para o editor da solução.

Aplicações autónomas

Quando seu aplicativo não está definido em uma solução, você precisa usar a appId propriedade.

Para localizar o ID do aplicativo:

1. Localize a aplicação na lista Power Apps
2. Abra Detalhes e anote o GUID da ID do aplicativo

NetworkRequestMocks

Para propriedades opcionais, se nenhum valor for especificado, o roteamento se aplicará a todos. Por exemplo, se method for null, enviaremos de volta a resposta simulada, seja qual for o método, desde que todas as outras propriedades correspondam.

Para aplicativos Sharepoint/Dataverse/Connector, requestURL e method pode ser o mesmo para todas as solicitações. x-ms-request-method e x-ms-request-url em cabeçalhos pode ser necessário configurar nesse caso para identificar diferentes solicitações.

Casos de teste

TestSteps

• TestSteps pode usar quaisquer funções Fx de potência do motor de teste existentes ou funções de teste específicas definidas por esta estrutura.
• O valor deve começar com um símbolo de pipe (|) para permitir expressões YAML de várias linhas seguidas por um sinal de igual (=) para indicar que é uma expressão Power Fx
• As funções devem ser separadas por ponto-e-vírgula (;).
• Os comentários podem ser usados e devem começar com caracteres de barra invertida dupla (//).

Exemplo de TestSteps

testCases:
   - testCaseName: Fill in a city name and do the search
   testSteps: |
      = Screenshot("connectorapp_loaded.png");
         SetProperty(TextInput1.Text, "Atlanta");
         Select(Button1);
         Assert(Label4.Text = "You are seeing the mock response", "Validate the output is from the mock");
         Screenshot("connectorapp_end.png");

testSettings

Usado para definir configurações para os testes no plano de teste.

extensionModules

Contém dados sobre extensões a serem habilitadas.

Este exemplo mostra como habilitar o namespace PowerFx Preview :

testSettings:
  extensionModules:
    enable: true
    allowPowerFxNamespaces:
    - Preview

Saiba mais sobre as funções de pré-visualização

Considerações sobre região e idioma

O Test Engine suporta várias configurações regionais e de idioma, como separadores decimais e de lista. A testSettings.locale propriedade controla esses comportamentos. Para obter mais informações, consulte Suporte global no Microsoft Power Fx.

Veja estas configurações de exemplo no repositórioPowerApps-TestEngine GitHub:

• Para regiões que usam ponto-e-vírgula como separadores de lista
• Para regiões que usam vírgulas como separadores decimais

Exemplo de powerFxTestTypes

powerFxTestTypes:
 - name: ControlName
   value: |
      {ControlName: Text} 
 - name: Options
   value: |
      [{Name: Text, Value: Number}]   

Este exemplo demonstra como definir tipos de Power Fx personalizados para uso em seus casos de teste. O ControlName tipo é definido como um registro com um único Text campo, enquanto o Options tipo é definido como uma tabela de registros, cada um contendo um Name campo de tipo Text e um Value campo de tipo Number. Os tipos personalizados podem ser usados para criar cenários de teste mais complexos e específicos, aumentando a flexibilidade e o poder de suas definições de teste.

Exemplo de testFunctions

testFunctions:
 - description: Wait until control is visible using Document Object Model (DOM) selector
   code: |
    WaitUntilVisible(control: Text): Void = 
      Preview.PlaywrightAction(Concatenate("//div[@data-id='", control, "']"), "wait");
 - description: Get the options for a control using Power Fx control from Model Driven App (MDA)
   code: |
    GetOptions(control: ControlName): Options =
      Preview.GetOptions(control);

Estes exemplos de funções de teste demonstram como definir funções Power Fx personalizadas para uso em seus casos de teste. A WaitUntilVisible função usa um seletor DOM para aguardar até que um controle especificado esteja visível, usando ações de Playwright. A função GetOptions recupera as opções para um controle especificado de um aplicativo controlado por modelo (MDA), utilizando o controle Power Fx. Essas funções personalizadas aumentam a flexibilidade e o poder de suas definições de teste, permitindo cenários de teste mais complexos e específicos.

Configuração do navegador

Cada testSettings requer pelo menos um BrowserConfiguration.

environmentVariables

Você pode armazenar diferentes tipos de valores como valores ambientais, mas o caso mais comum é o armazenamento de informações de credenciais com uma lista de usuários.

users

Para garantir que as credenciais sejam armazenadas de maneira segura, a definição de teste faz referência aos usuários usando um personaNamearquivo . Não há suporte para o armazenamento de credenciais em arquivos de plano de teste.

Exemplo:

environmentVariables:
    - users:
        - personaName: "User1"
          emailKey: "user1Email"
        - personaName: "User2"
          emailKey: "user2Email"

O personaName é usado como parte da definição de teste para indicar qual usuário executar o teste como.

Mecanismos de armazenamento de credenciais suportados

Para armazenar credenciais como variáveis de ambiente, você pode defini-las da seguinte maneira:

# In PowerShell - replace variableName and variableValue with the correct values
$env:variableName = "variableValue"

No YAML, duas propriedades precisam ser definidas para indicar que as credenciais desse usuário são armazenadas em variáveis de ambiente:

• emailKey: A variável de ambiente usada para armazenar o e-mail do usuário.

Exemplo YAML:

    - personaName: "User1"
      emailKey: "user1Email"

Exemplo de PowerShell para definir credenciais de usuário com base em YAML:

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

Consulte também

Visão geral do mecanismo de teste do Power Apps (visualização)
Power Apps Test Engine Power Fx funções (visualização)