Tester des applications pilotées par modèle avec Test Engine (version préliminaire)

Le test de votre application pilotée par modèle avec Test Engine nécessite les étapes suivantes :

1. Créer un plan de test
2. Configurer votre utilisateur
3. Exécuter le test
4. Afficher les résultats

Créer un plan de test

Créez un fichier yaml à l’aide du schéma du plan de test expliqué dans Format YAML de Power Apps Test Engine (version préliminaire).

Activer la prévisualisation

Actuellement, toutes les fonctionnalités de test d’extension application pilotée par modèle nécessitent l’utilisation des fonctions d'Aperçu. Pour les activer, ajoutez Preview à la liste allowPowerFxNamespaces dans extensionModules de vos testSettings.

Cet exemple vous montre comment ajouter ceci :

testSettings:
  extensionModules:
    enable: true
    allowPowerFxNamespaces:
    - Preview

Configurer votre utilisateur

Test Engine dispose actuellement des méthodes d’authentification suivantes :

Vous ne pouvez pas stocker les informations d’identification du test dans les fichiers du plan de test. Vous devez sélectionner Storagestate ou Dataverse comme emplacement sécurisé pour stocker les informations d’identification. Le fichier de plan de test contient des références aux variables d’environnement utilisées pour le persona utilisateur. Par exemple, l’extrait de code YAML suivant indique que les variables d’environnement user1Email sont utilisées :

environmentVariables:
  users:
    - personaName: User1
      emailKey: user1Email

Consultez la page Utilisateurs pour plus d’informations.

Utilisez le script PowerShell suivant pour stocker le nom d’utilisateur dans vos variables d’environnement.

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

Exécuter le test

Utilisez la commande pac test run de PAC CLI pour exécuter votre plan de test.

Paramètres obligatoires

Vous devez fournir les informations suivantes :

• --test-plan-file : Chemin d’accès au fichier de votre plan de test
• --tenant : Votre ID client
• --environment-id : Votre ID d'environnement
• --domain : URL du domaine de la page d'application pilotée par modèle à tester

Formats d'URL pour les applications pilotées par modèle

Pour les applications pilotées par modèle, le paramètre --domain varie en fonction du type de page que vous testez. Le format d’URL doit spécifier le pagetype correct en fonction de votre scénario de test :

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

Intégration de Dataverse

Pour activer l’intégration de Dataverse à vos tests d'application pilotée par modèle, ajoutez le paramètre enableDataverseFunctions dans votre testSettings :

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

Lorsque vous activez l’intégration Dataverse, vous devez ouvrir la CLI Azure avec un utilisateur ou un principal de service qui a des droits sur l’environnement Dataverse. Vous pouvez utiliser la commande : az login Pour plus d’informations : Se connecter avec Azure CLI.

L’URL de l'API Dataverse utilisée pour l'intégration est obtenue soit à partir du nom de domaine hôte du paramètre pac test run--domain, soit en définissant une variable d’environnement PowerShell nommée DATAVERSE_URL.

Afficher les résultats

Une fois les tests terminés, vous pouvez visualiser les résultats de votre test dans le fichier .trx situé dans le répertoire de sortie. Ce dossier contient toutes les captures d’écran ou vidéos capturées par vos tests lorsque recordVideo est défini sur true dans le fichier yaml du plan de test.