Probar aplicaciones controladas por modelos con Test Engine (obsoleto)

Nota:

El motor de prueba está obsoleto y se quitará en una versión futura. Use ejemplos de Power Platform Playwright para las funcionalidades de automatización de pruebas en Power Platform y los servicios de Dynamics 365.

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

  1. Crear un plan de pruebas
  2. Configurar un usuario
  3. Ejecutar la prueba
  4. Ver resultados

Creación de un plan de pruebas

Cree un archivo YAML utilizando el esquema del plan de prueba descrito en el formato YAML del motor de pruebas de Power Apps (en desuso).

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 su propia clave administrada por el cliente, cifrada con un certificado X.509, usando ASP.NET Core Data Protection

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 al 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

Cuando habilita la integración de Dataverse, se requiere que abra la CLI de Azure con un usuario o un principal de servicio que tenga derechos sobre el entorno de Dataverse. Puede usar el comando: az login Más información: Sign in with CLI de Azure.

La URL de la API de Dataverse utilizada para la integración se obtiene del nombre de dominio del host del parámetro pac test run--domain o definiendo una variable de entorno de PowerShell denominada DataverseDATAVERSE_URL.

Ver los 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 las capturas de pantalla o los videos que se obtienen en sus pruebas cuando recordVideo está configurado en true en el YAML del plan de prueba.