Referência de funções do módulo do Motor de Teste (obsoleto)

Observação

O Test Engine está obsoleto e será removido numa versão futura. Use Power Platform Playwright para capacidades de automação de testes no Power Platform e nos serviços Dynamics 365.

Esta tabela fornece uma visão geral dos vários módulos disponíveis no Power Apps Test Engine e das suas funções especializadas.

Função Description Link do módulo
ConsentDialogFunction Verifica páginas personalizadas de um aplicativo controlado por modelo em busca de caixas de diálogo de consentimento e as manipula automaticamente durante a execução do teste. testengine.module.mda
PauseFunction Pausa o teste atual e permite que o usuário interaja com o navegador e inspecione o estado quando o modo sem cabeça é falso. Útil para testes de depuração. testengine.module.pause
PlaywrightActionFunction Executa ações de Playwright para a página atual, permitindo a manipulação direta de elementos DOM usando seletores CSS e XPath. testengine.module.playwrightaction
PlaywrightActionValueFunction Executa ações de Playwright que exigem parâmetros de valor extra, como preencher campos de formulário ou selecionar opções suspensas. testengine.module.playwrightaction
PlaywrightScriptFunction Permite a execução de scripts C# personalizados que interagem com APIs Playwright, proporcionando a máxima flexibilidade para cenários complexos de automação. TestEngine.Module.PlayWrightScript
CheckConnectionExistsFunction Verifica se existe uma ligação específica na Power Platform usando o fornecedor do portal Power Apps. testengine.module.powerapps.portal
CreateConnectionFunction Cria conexões de plataforma de energia durante a execução do teste. Nota: Essa abordagem deve ser considerada um backup, pois o ideal é que as conexões sejam criadas com entidades de serviço sempre que possível. testengine.module.powerapps.portal
ExportConnectionsFunction Exporta informações de conexão para um arquivo JSON para fins de documentação ou reutilização. Compatível com o provedor do portal PowerApps. testengine.module.powerapps.portal
GetConnectionsFunction Consulta e recupera informações de conexão disponíveis da Power Platform. Compatível com o provedor do portal PowerApps. testengine.module.powerapps.portal
UpdateConnectionReferencesFunction Atualiza as referências de conexão da Power Platform. Deve ser usado como uma abordagem de backup, pois as conexões idealmente devem ser gerenciadas por entidades de serviço. testengine.module.powerapps.portal
SampleFunction Uma função de exemplo simples que demonstra como implementar um ReflectionFunction básico. Útil como um modelo inicial para o desenvolvimento de novas funções. testengine.module.sample
SimulateConnectorFunction Permite simular as respostas do conector, permitindo que os testes sejam executados sem dependências reais do serviço externo. testengine.module.simulação
SimulateDataverseFunction Fornece recursos para simular respostas do Dataverse, permitindo testes sem dependências reais do Dataverse. testengine.module.simulação
VisualCompareFunction Executa a comparação visual entre capturas de tela usando OpenCV, permitindo a verificação baseada em imagem de elementos da interface do usuário. TestEngine.Module.VisualCompare

Como usar essas funções

Essas funções estão disponíveis através do namespace Power Fx Preview quando os módulos correspondentes estão habilitados. Para habilitar um módulo em suas configurações de teste, adicione o seguinte à sua configuração YAML:

testSettings:
  extensionModules:
    enable: true
    allowPowerFxNamespaces:
      - Preview

Por exemplo, para usar a função PlaywrightAction em seu teste:

Preview.PlaywrightAction("//button[@id='submit']", "click")

Processo de contribuição

Se quiser desenvolver mais módulos e funções para o Test Engine, consulte a documentação Feature Lifecycle para informações sobre a progressão das funcionalidades desde open source contribuições até à disponibilidade geral.