Compartir por


Probar aplicacións baseadas en modelos con Test Engine (vista previa)

Nota

As funcionalidades de vista previa non se deseñaron para uso de produción e poden ter funcionalidade restrinxida. Estas funcionalidades están dispoñibles antes da versión oficial para que os clientes poidan obter acceso a elas rápido e fornecer comentarios.

Probar a túa aplicación baseada en modelos con Test Engine require os seguintes pasos:

  1. Crear un plan de probas
  2. Configura o teu usuario
  3. Executar a proba
  4. Ver os resultados

Crear un plan de probas

Crea un ficheiro yaml usando o esquema do plan de proba explicado en Power Apps formato YAML do Motor de Proba (previsualización).

Suxestión

Revisa os planos de mostra dispoñibles no repositorio GitHub.

Activar a previsualización

Actualmente, todas as capacidades de proba de extensións de aplicacións baseadas en modelos requiren o uso de funcións de vista previa . Para activalos, engádeos Preview á allowPowerFxNamespaces lista en extensionModules da túa testSettings.

Este exemplo móstrache como engadir isto:

testSettings:
  extensionModules:
    enable: true
    allowPowerFxNamespaces:
    - Preview

Configura o teu usuario

Test Engine ten actualmente estes métodos de autenticación:

Método Descripción
Estado de almacenamento Garda o estado autenticado do usuario localmente no perfil de usuario usando a API de Protección de Datos Windows de Microsoft
Dataverse Garda o estado autenticado do usuario dentro de Dataverse usando a túa propia chave xestionada polo cliente cifrada cun certificado X.509 usando ASP.NET Core Data Protection

Non podes almacenar credenciais de proba en ficheiros de plans de proba. Debes seleccionar Storagestate ou Dataverse como localización segura para almacenar as credenciais. O ficheiro do plan de probas contén referencias ás variables de ambiente que se usan para a personalización do usuario. Por exemplo, o seguinte fragmento de código YAML indica que se usan as variables de ambiente user1Email :

environmentVariables:
  users:
    - personaName: User1
      emailKey: user1Email

Consulta Usuarios para obter máis información.

Usa o seguinte script de PowerShell para almacenar o nome de usuario nas túas variables de ambiente.

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

Executar a proba

Usa o comando PAC CLI pac test run para executar o teu plan de probas.

Parámetros obrigatorios

Debe proporcionar a seguinte información:

  • --test-plan-file: Ruta ao ficheiro do plan de probas
  • --tenantO teu ID de inquilino
  • --environment-id: O ID do teu entorno
  • --domainURL de dominio da páxina da aplicación baseada en modelos para probar

Formatos de URL para aplicacións baseadas en modelos

Para as aplicacións baseadas en modelos, o parámetro --domain varía segundo o tipo de páxina que se estea a probar. O formato da URL debería especificar o correcto pagetype segundo o escenario de proba:

# 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 Integración

Para activar a Dataverse integración coas probas da aplicación baseada en modelos, engade o enableDataverseFunctions parámetro na túa Configuracióndetest:

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

Cando activas a integración con Dataverse, tes que abrir Azure CLI cun usuario ou principal de servizo que teña dereitos sobre o entorno Dataverse. Podes usar o comando: az login Máis información: Inicia sesión con Azure CLI.

O URL da API Dataverse empregado para a integración obtense do nome de dominio do host do parámetro execución da proba de pac--domain ou definindo unha variable de ambiente de PowerShell chamada DATAVERSE_URL.

Ver os resultados

Cando rematen as probas, podes ver os resultados da túa proba no ficheiro .trx que se atopa no directorio de saída. Este cartafol contén calquera captura de pantalla ou vídeo realizado polas túas probas cando recordVideo está definido como true no plan de probas yaml.