Vue d’ensemble de Power Apps Test Engine (version préliminaire)

  • Article

[Cet article fait partie de la documentation en version préliminaire et peut faire l’objet de modifications.]

Power Apps Test Engine est un composant au sein de Power Platform CLI (PAC CLI) utilisé pour tester les applications canevas autonomes dans Power Apps. Vous devez Installer Microsoft Power Platform CLI pour utiliser Test Engine.

Important

  • Il s’agit d’une fonctionnalité en version préliminaire.
  • Les fonctionnalités en version préliminaire ne sont pas destinées à être utilisées en production et peuvent avoir des fonctionnalités restreintes. Ces fonctionnalités sont disponibles avant une publication officielle afin que les clients puissent y accéder de façon anticipée et fournir des commentaires.

Avantages

Power Apps Test Engine offre les avantages suivants :

  • Création de tests Power Fx : créez des tests au format YAML en utilisant le langage Power Fx familier.
  • Abstraction de DOM : utilisez des références pour contrôler les noms définis dans Power Apps Studio lorsque vous créez des tests. Il n’est pas nécessaire d’utiliser JavaScript ou de vous familiariser avec la sortie Document Object Model (DOM) affichée par le navigateur de l’application.
  • Simulation de connecteur : vous pouvez créer des simulations des appels réseau effectués par l’application à l’aide de connecteurs. Vous pouvez tester l’application sans la modifier et éviter les effets secondaires indésirables des API externes.
  • Prise en charge des captures d’écran et des enregistrements vidéo : vous pouvez utiliser Test Engine pour effectuer des captures d’écran et enregistrer des vidéos de l’exécution du test. Ces images et enregistrements aident à diagnostiquer les tests ayant échoué et à comprendre l’expérience réelle des cas de test ayant échoué.

Tester votre application

Tester votre application 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

Les plans de test sont définis au format YAML. Vous pouvez créer votre propre plan de test ou télécharger des tests enregistrés depuis Test Studio.

Créer votre propre 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).

Télécharger les tests enregistrés depuis Test Studio

Si vous avez enregistré des tests dans Test Studio, vous pouvez les télécharger depuis Test Studio pour les réutiliser dans Test Engine.

  • Utilisez le bouton Télécharger la suite dans Test Studio pour télécharger le plan de test. Choisissez la suite de tests à télécharger si vous disposez de plusieurs suites de tests.

    Capture d’écran du bouton de téléchargement de la suite de tests de Test Studio

  • Sinon, utilisez le bouton Télécharger disponible sous chaque suite de tests.

    Capture d’écran du bouton individuel de téléchargement de la suite de tests de Test Studio

  • Assurez-vous de mettre à jour le fichier de configuration et les configurations utilisateur si vous utilisez un locataire ou un environnement différent pour cette application.

Configurer votre utilisateur

Test Engine ne prend pas en charge l’authentification multifacteur. Utilisez un compte qui ne nécessite qu’un nom d’utilisateur et un mot de passe pour vous connecter pour vos tests.

Vous ne pouvez pas stocker les informations d’identification du test dans les fichiers du plan de test. Stockez-les dans les variables d’environnement. Le fichier du plan de test contient des références aux variables d’environnement utilisées pour les informations d’identification. Par exemple, l’extrait YAML suivant indique que les variables d’environnement user1Email et user1Password sont utilisées :

environmentVariables:
  users:
    - personaName: User1
      emailKey: user1Email
      passwordKey: user1Password

Consultez la page Utilisateurs pour plus d’informations.

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

$env:user1Email = "someone@example.com"
$env:user1Password = "fake password"

Exécuter le test

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

  • Chemin d’accès au fichier de votre plan de test
  • EnvironmentId
  • TenantId

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.

Limitations

Voici les limitations connues lors de l’utilisation de Power Apps Test Engine.

  • L’authentification multifacteur n’est pas prise en charge. Utilisez un compte qui ne nécessite qu’un nom d’utilisateur et un mot de passe pour exécuter vos tests.
  • Les paramètres régionaux du navigateur suivent les paramètres par défaut de votre navigateur
  • Les contrôles modernes (version préliminaire) ne sont pas pris en charge pour le moment

Navigateurs pris en charge

Test Engine prend actuellement en charge les navigateurs suivants.

  • Chrome
  • Firefox
  • WebKit

Considérations supplémentaires

Voici quelques éléments supplémentaires à prendre en compte pour vos plans de test.

Langues et régions qui utilisent le point comme séparateur décimal

La syntaxe de Power Fx peut différer en fonction des paramètres de langue de votre système. Utilisez la propriété locale dans la section testSettings du fichier du plan de test pour spécifier les paramètres régionaux dans lesquels votre Power Fx est écrit. (Voir locale dans testSettings). Ceci est utile si vous travaillez dans des régions qui utilisent différents séparateurs décimaux ou de milliers. Par exemple, , au lieu de . pour les décimales et ; au lieu de ,.

Consultez les exemples suivants dans lesquels la propriété locale est spécifiée comme exemple de son utilisation :

  1. ; au lieu de , pour le séparateur - testPlanForRegionUsePeriodAsDecimalSeparator.fx.yaml
  2. , au lieu de . pour le séparateur - testPlanWithCommaForDecimal.fx.yaml.fx.yaml

Comment les applications sont référencées dans les fichiers du plan de test

La façon dont les fichiers du plan de test font référence à l’application cible dépend du fait que l’application se trouve ou non dans une solution. Nous vous recommandons d’utiliser les solutions autant que possible car elles offrent une plus grande portabilité.

Utiliser des applications au sein des solutions

Les fichiers du plan de test pour les applications qui font partie de la Vue d’ensemble des solutions sont portables dans tous les environnements. Pour les applications basées sur des solutions, le plan de test fait référence à l’application cible avec un nom logique (la propriété LogicalName de l’application) qui ne change pas si l’application est déplacée vers un autre environnement.

  1. Localiser le nom logique de l’application
    1. Dans l’onglet Solutions , ouvrez la solution qui contient l’application
    2. Sélectionnez Applications
    3. Notez la colonne Nom. Il s’agit du nom logique de l’application (pas du nom complet)
  2. Mettre à jour le fichier de votre plan de test
    1. Ouvrez le fichier YAML du plan de test pour l’application
    2. Remplissez la valeur appLogicalName avec le nouveau nom logique de l’application

Utiliser des applications en dehors des solutions

Si vous déplacez une application qui ne fait pas partie d’une solution vers un nouvel environnement, vous devez mettre à jour manuellement le fichier du plan de test pour faire référence à l’application. Comment mettre à jour un fichier de plan de test pour une application non basée sur une solution :

  1. Localisez l’ID d’application de l’application dans son nouvel emplacement
    1. Dans la liste Applications, localisez l’application et ouvrez le menu contextuel
    2. Sélectionnez Détails
    3. Notez le GUID de l’ID d’application dans le volet Détails
  2. Mettre à jour le fichier de votre plan de test
    1. Ouvrez le fichier YAML du plan de test pour l’application
    2. Remplissez l’appId avec le nouvel ID d’application

Voir aussi

Format YAML de Power Apps Test Engine (version préliminaire)
Fonctions Power Fx de Power Apps Test Engine (version préliminaire)

Notes

Pouvez-vous nous indiquer vos préférences de langue pour la documentation ? Répondez à un court questionnaire. (veuillez noter que ce questionnaire est en anglais)

Le questionnaire vous prendra environ sept minutes. Aucune donnée personnelle n’est collectée (déclaration de confidentialité).