Compartir a través de


Pruebe aplicaciones basadas en modelos con Test Engine (versión preliminar)

Nota

Las características en vista previa no se han diseñado para un uso de producción y pueden tener una funcionalidad restringida. Estas características están disponibles antes del lanzamiento oficial, para que los clientes puedan obtener acceso anticipado y proporcionar comentarios.

Para probar su aplicación basada en modelos con Test Engine, debe realizar los siguientes pasos: ...

  1. Creación de un plan de prueba
  2. Configurar un usuario
  3. Ejecutar la prueba
  4. Ver resultados

Crear un plan de pruebas

Cree un archivo yaml utilizando el esquema del plan de prueba explicado en formato YAML del motor de prueba de Power Apps (versión preliminar).

Sugerencia

Revise los planes de muestra disponibles en el repositorio de GitHub.

Habilitar la vista previa

Actualmente, todas las capacidades de prueba de extensiones de aplicaciones basadas en modelos requieren el uso de funciones de vista previa . Para habilitarlos, agregue Preview a la lista allowPowerFxNamespaces en módulosDeExtensión de su configuraciónDePrueba.

Este ejemplo le muestra cómo agregar esto:

testSettings:
  extensionModules:
    enable: true
    allowPowerFxNamespaces:
    - Preview

Configurar un usuario

Test Engine actualmente tiene estos métodos de autenticación:

Método Descripción
Estado de almacenamiento Almacene el estado de usuario autenticado localmente en el perfil de usuario mediante microsoft Windows Data Protection API
Dataverse Almacene el estado del usuario autenticado en Dataverse usando una clave administrada por el cliente, cifrada con un certificado X.509, mediante Protección de Datos ASP.NET Core

No puede almacenar credenciales de prueba en archivos de planes de prueba. Debe seleccionar Storagestate o Dataverse como la ubicación segura para almacenar las credenciales. El archivo del plan de prueba contiene referencias a qué variables de entorno se utilizan para la personalidad del usuario. Por ejemplo, el siguiente fragmento de YAML indica que se utilizan las variables de entorno: user1Email

environmentVariables:
  users:
    - personaName: User1
      emailKey: user1Email

Ver Usuarios para obtener más información.

Utilice el siguiente script de PowerShell para almacenar el nombre de usuario en sus variables de entorno.

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

Ejecutar la prueba

Utilice el comando PAC CLI pac test run para ejecutar su plan de prueba.

Parámetros necesarios

Tiene que proporcionar la siguiente información:

  • --test-plan-file: Ruta a su archivo de plan de prueba
  • --tenant:Su ID de inquilino
  • --environment-id: Su ID de entorno
  • --domain:URL del dominio de la página de la aplicación basada en modelos que se va a probar

Formatos de URL para aplicaciones basadas en modelos

Para las aplicaciones basadas en modelos, el parámetro varía según el tipo de página que estés probando. --domain El formato de la URL debe especificarse correctamente según el escenario de prueba: pagetype

# 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"

Integración con Dataverse

Para habilitar la integración de Dataverse con las pruebas de su aplicación basada en modelos, agregue el parámetro enableDataverseFunctions en su configuración de prueba:

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

Al habilitar la integración de Dataverse, es necesario abrir Azure CLI con un usuario o una entidad de servicio que tenga derechos para el entorno de Dataverse. Puede usar el comando: az login Más información: Sign in with Azure CLI.

La URL de la API de Dataverse utilizada para la integración se obtiene bien a partir del nombre de dominio del host del parámetro de ejecución de prueba de pac--domain, o bien definiendo una variable de entorno de PowerShell denominada DATAVERSE_URL.

Ver resultados

Cuando se completen las pruebas, podrá ver los resultados de su prueba en el archivo .trx ubicado en el directorio de salida. Esta carpeta contiene capturas de pantalla o videos capturados por sus pruebas cuando recordVideo está configurado en true en el yaml del plan de prueba.