Utiliser l’outil de script de page intégré au client pour les tests d’acceptation

Activée pour	Version préliminaire publique	Disponibilité générale
Utilisateurs, automatiquement	1er avril 2024	-

Valeur commerciale

Avec l’outil de script de page, les clients et les consultants peuvent facilement enregistrer et rejouer des tests d’acceptation utilisateur directement dans le client Web Business Central, ce qui permet d’accroître la couverture des tests, tout en réduisant les coûts.

Détails de la fonctionnalité

L’outil de script de page du client Web Business Central vous permet d’enregistrer vos actions (par exemple, l’ouverture de pages ou la saisie de données) et de les relire. Vous pouvez sauvegarder l’enregistrement et le partager avec d’autres personnes pour une lecture ultérieure. L’un des cas d’utilisation importants de cet outil consiste à capturer et à exécuter des tests d’acceptation utilisateur, ce qui représente également l’objectif initial de cette vague de lancement.

Ouvrir l’outil

Dans le client Web, l’outil de script de page est accessible depuis le menu Paramètres (icône de roue dentée). Cependant, l’action du Script de page n’apparaît que si vous disposez d’une autorisation d’enregistrement ou de lecture pour utiliser l’outil.

Dans le volet Script de page qui s’ouvre à droite, il vous est demandé si vous souhaitez démarrer un nouvel enregistrement ou en ouvrir un existant pour l’inspecter ou le relire.

Enregistrement

Pour commencer à enregistrer vos actions (en d’autres termes, démarrer un test d’acceptation utilisateur), sélectionnez Démarrer un nouveau ou Nouveau>Nouvel enregistrement dans la barre d’outils en haut du volet. Lorsque l’enregistrement démarre, comme indiqué par le rond rouge dans la barre d’outils, effectuez les actions que vous souhaitez capturer.

L’outil de script de page capture vos interactions à l’écran et les actions qui en résultent : ouverture ou fermeture de pages, sélections, saisie de données, etc.

Lors de l’enregistrement, il est possible de supprimer la dernière étape capturée.

Pour arrêter l’enregistrement, utilisez le bouton Arrêt dans la barre d’outils. Pour reprendre afin d’enregistrer d’autres étapes, sélectionnez le bouton rond Démarrer l’enregistrement dans la barre d’outils.

L’illustration suivante montre quelques étapes capturées et la barre d’outils (pendant l’enregistrement).

Options de capture d’étapes

Pendant l’enregistrement, vous pouvez insérer manuellement des étapes spéciales en cliquant avec le bouton droit sur un contrôle de page (un champ, par exemple) et en sélectionnant une option appropriée. Ces options sont expliquées dans les sections suivantes.

Copier et coller depuis le presse-papiers

L’outil de script de page est livré avec son propre presse-papiers qui permet de copier les valeurs des champs puis, par exemple, de les insérer dans d’autres champs, de les coller dans des expressions ou de les utiliser pour valider les résultats. Pour copier et coller pendant l’enregistrement, cliquez avec le bouton droit sur un contrôle de page et sélectionnez Copier ou Coller dans le menu contextuel.

Coller les informations de session

Lors de l’enregistrement, vous avez accès aux informations de la session, telles que l’identifiant utilisateur. Cela vous permet, par exemple, de définir des filtres en fonction de l’utilisateur actuel. Pour insérer l’identifiant utilisateur, cliquez avec le bouton droit sur un contrôle dans la page et sélectionnez Coller>Informations sur la session>Identifiant utilisateur. Pour voir un exemple, reportez-vous à l’image précédente.

Valider un résultat donné

Pendant l’enregistrement, vous pouvez insérer des étapes de validation pour vérifier le résultat lors de la lecture de l’enregistrement. Pour ce faire, cliquez avec le bouton droit sur un contrôle, tel qu’un champ ou un repère, et sélectionnez Valider dans le menu contextuel. Cela insère une étape de validation avec la valeur actuelle. Si vous souhaitez modifier la valeur validée, vous pouvez accéder à l’étape de validation dans la liste des étapes du Script de page, sélectionner le menu contextuel (...), puis Propriétés.

Rendre certaines étapes conditionnelles

Une autre option lors de l’enregistrement consiste à insérer une étape de branche conditionnelle. Par exemple, supposons que vous souhaitiez uniquement effectuer certaines étapes pendant la lecture s’il n’y a aucune ligne actuelle dans une liste.

Pour insérer une branche d’étapes conditionnelles, cliquez avec le bouton droit sur un contrôle de page, sélectionnez Ajouter des étapes conditionnelles lorsque, puis sélectionnez une option.

Une fois l’étape conditionnelle insérée, vous pouvez ajouter d’autres étapes qui doivent être effectuées si la condition est remplie.

Pour terminer la branche de condition, sélectionnez Fin de la portée dans la liste des étapes du Script de page.

Vous pouvez modifier la condition réelle en sélectionnant l’étape de condition dans la liste des étapes du Script de page, en développant les propriétés, puis en définissant la règle et la valeur de comparaison.

Modifier les étapes capturées

Pendant l’enregistrement, ainsi que la lecture, vous pouvez modifier une étape capturée dans le volet Script de page à l’aide du menu contextuel ... de l’étape. Les options du menu contextuel dépendent du mode d’enregistrement ou de lecture, ainsi que du type d’étape. Certaines de ces options sont expliquées dans les sections suivantes.

Propriétés

Certaines étapes ont des propriétés, qui comprennent des éléments tels que des étapes conditionnelles ou des étapes de validation. Vous pouvez voir les propriétés d’une étape en sélectionnant l’option Propriétés dans le menu contextuel d’une étape.

Utiliser des expressions dans les propriétés

Les valeurs et les conditions peuvent utiliser des expressions pour effectuer des calculs simples. Power Fx est utilisé comme langage d’expression. Un lien vers la documentation de référence sur les expressions Power Fx est disponible dans l’interface utilisateur.

Outre les fonctions Power Fx, trois objets de niveau supérieur sont disponibles :

• Clipboard pour accéder aux entrées actuelles copiées dans l’enregistrement.
• Parameters pour accéder à la valeur de tous les paramètres transmis à cet enregistrement.
• SessionInfo pour les informations de la session telles que l’identifiant utilisateur actuel.

En voici quelques exemples :

• Pour vérifier qu’une valeur précédemment copiée est incrémentée dans une étape de validation, utilisez l’expression "Clipboard.'SO Processor Activities - ReadyToShip' + 1"
• Pour générer un nom « aléatoire » à utiliser dans une étape de saisie, utilisez l’expression "Customer " & Today().

Gérer des pages facultatives

Il arrive parfois qu’une page ne s’affiche pas dans un flux enregistré parce qu’elle dépend des données ou des paramètres. Il peut s’agir, par exemple, de la boîte de dialogue de confirmation qui s’affiche lors de la clôture d’une commande client. Pour la gérer, vous pouvez en faire une page facultative, dont les étapes ne s’exécuteront que si elle est affichée. Pour rendre une page facultative, accédez à la liste des étapes du Script de page, sélectionnez l’étape enregistrée appelée La page X a été affichée, sélectionnez le menu contextuel ..., puis Faire de cette page une page facultative.

Les étapes qui se produisent sur la page sont en retrait pour indiquer qu’elles sont facultatives, en fonction de l’affichage de la page.

Lecture

Pour lire un enregistrement que vous venez de capturer ou que vous avez ouvert à partir d’un fichier, sélectionnez le bouton Lecture dans la barre d’outils.

Pendant la lecture, vous pouvez effectuer les actions suivantes :

• Avancer ou reculer d’une étape à la fois à l’aide des boutons Avancer et Reculer de la barre d’outils. Si vous revenez en arrière, les modifications ne sont pas annulées. Vous devez annuler les modifications manuellement.
• Revenez au début de l’enregistrement.
• Exécutez l’enregistrement jusqu’à une étape donnée. Pour ce faire, sélectionnez le menu contextuel ..., puis sélectionnez Exécuter jusqu’ici.

Au fur et à mesure de leur lecture, l’outil enregistre si les étapes se sont terminées correctement (coche verte) ou ont échoué (point d’exclamation rouge) et indique le résultat de toutes les étapes qui valident un résultat.

Sauvegarder un enregistrement

Vous pouvez sauvegarder l’enregistrement à partir de la barre d’outils. Cela crée un fichier YAML que vous pouvez télécharger, partager, modifier et rouvrir pour lecture.

Partager un enregistrement

Vous pouvez partager un enregistrement sous forme de lien en sélectionnant Partager dans la barre d’outils. Ce lien comprend l’enregistrement complet et son résultat de lecture. Dans l’exemple suivant, la lecture a échoué au milieu de l’enregistrement.

Actions de capture prises en charge

L’outil de script de page vise à capturer les actions provenant de l’exécution du code AL. Il ne s’agit pas d’un outil d’automatisation HTML générique. Par conséquent, il ne peut pas automatiser des éléments tels que les compléments de contrôle (comme les graphiques), les éléments intégrés Power BI ou Power Apps, ou quoi que ce soit en dehors de l’expérience du client Web Business Central.

Donnez-nous votre avis

Aidez-nous à améliorer Dynamics 365 Business Central en proposant des idées et en nous transmettant vos suggestions et commentaires. Consultez le forum à l’adresse https://aka.ms/bcideas.

Voir aussi

Utiliser l’outil de script de page pour les tests d’acceptation (documents)