Étapes de test d’interface utilisateur personnalisées
Testez les interfaces utilisateur personnalisées telles que les pages d’interface utilisateur et les macros d’interface utilisateur en récupérant leurs composants de page HTML et JavaScript et en identifiant les actions de test qu’elles prennent en charge.
Les étapes de test d’interface utilisateur personnalisées nécessitent de récupérer et d’identifier les composants pouvant être testés à partir d’une Framework de tests automatisés page Web cible.
Composants testables
Les composants de page testables sont constitués de HTML et JavaScript standard avec ces caractéristiques.
- Sont définis ou cliqués par l’interaction de l’utilisateur
- Les composants de page testables permettent aux utilisateurs de définir une valeur ou de cliquer dessus.
- Sont accessibles à partir du modèle d’objet de document (DOM)
- Les composants de page testables sont accessibles à partir du DOM et prennent en charge la manipulation JavaScript du DOM. Les étapes de test d’interface utilisateur personnalisées ne peuvent pas accéder aux composants de page dans le Shadow DOM.
- Sont accessibles à JavaScript
- Les composants de page testables sont accessibles en JavaScript. Les étapes de test d’interface utilisateur personnalisées ne peuvent pas accéder aux composants de page qui interagissent directement avec le système d’exploitation, tels que les champs de fichier ou affichent du contenu non HTML tel que des fichiers Excel ou PDF.
- Ne sont pas exclus des tests d’interface utilisateur personnalisés
- Les composants de page testables ne sont pas exclus des tests d’interface utilisateur personnalisés. Framework de tests automatisés Exclut les composants de page qui peuvent déjà être testés par d’autres catégories d’étapes de test et exclut également les composants de page associés aux ServiceNow AI Platform fonctionnalités.
- sont accessibles à l’inspecteur de page
- Les composants de page testables doivent renvoyer des résultats lorsqu’ils Inspecteur de pagesont affichés à partir du fichier . Les concepteurs de tests peuvent utiliser l’inspecteur de page pour identifier les composants d’une page pouvant être testés.
- Boutons
- Liens
- Texte de la page
- Contrôles de l'interface utilisateur
- Macros d'interface utilisateur
- ui_date
- ui_date_time
- ui_reference
- Pages de l'interface utilisateur
- Assistants
Ces éléments d’interface utilisateur sont des exemples de composants de page impossibles à tester.
| Raison impossible à tester | Composants de page ne pouvant pas être testés |
|---|---|
| Ils ne sont ni définissables ni interactifs | Contrôles masqués |
| Commentaires HTML | |
| Éléments de mise en page HTML tels que div, section et span. | |
| Éléments de script HTML | |
| Sont inaccessibles à partir du DOM | Tableaux de bord |
| Images | |
| Listes | |
| Rapports | |
| DOM fantôme | |
| Sont inaccessibles à JavaScript | Fichiers Excel |
| Champs de fichier | |
| Fichiers PDF | |
| Sont ServiceNow AI Platform des fonctionnalités | Concepteur de flux |
| Studio | |
| Mettre à niveau le moniteur | |
| Peuvent être testés par d’autres catégories d’étapes de test | Étiquettes de champs de formulaire |
| Valeurs de champ de formulaire | |
| Catalogue de services | |
| Espaces de travail |
Composants de page définissables
Un composant définissable est un élément d’interface utilisateur qui a une valeur dynamique telle qu’un champ d’entrée de texte. Les composants définissables prennent en charge ces actions de test et étapes de test.
| Actions de l’inspecteur de page | Étapes de test d’interface utilisateur personnalisées |
|---|---|
| Définir la valeur de composant | Définir les valeurs de composant (interface utilisateur personnalisée) |
| Obtenir la valeur de composant | Déclarer le texte sur la page (interface utilisateur personnalisée) |
| Validation de la valeur de composant (interface utilisateur personnalisée) | |
| Est un composant désactivé | Validation de l'état de composant (interface utilisateur personnalisée) |
Les composants définissables ont un type de données qui détermine les valeurs qu’une étape de test d’interface utilisateur personnalisée peut définir. Par exemple, un composant de page destiné à afficher une référence à un enregistrement particulier peut avoir un type de données de référence pour afficher uniquement les valeurs d’ID système.
- Date
- Date/Heure
- Référence
Consultez Remplacer le type de données du composant pour plus d'informations.
Composants de page cliquables
Un composant cliquable est un élément d’interface utilisateur avec lequel les utilisateurs peuvent interagir en cliquant, tels que des entrées de type case à cocher ou case d’option. Les composants cliquables prennent en charge ces actions de test.
| Actions de l’inspecteur de page | Étapes de test d’interface utilisateur personnalisées |
|---|---|
| Cliquer sur le composant | Cliquer sur composant (interface utilisateur personnalisée) |
| Obtenir la valeur de composant | Déclarer le texte sur la page (interface utilisateur personnalisée) |
| Validation de la valeur de composant (interface utilisateur personnalisée) | |
| Est un composant désactivé | Validation de l'état de composant (interface utilisateur personnalisée) |
Les composants cliquables n’ont pas de type de données, car ils n’ont pas de valeurs dynamiques.
Composants de page récupérés
Framework de tests automatisés stocke une liste des composants de page récupérés pour chaque page d’interface utilisateur personnalisée que vous testez. Les étapes de test d’interface utilisateur personnalisées affichent la liste des composants récupérés à partir des champs Composant et Valeurs de composant .
Par défaut, la liste des composants de la page est statique et n’est mise à jour que lorsque les concepteurs de tests cliquent manuellement sur Récupérer les composants. Les administrateurs peuvent activer la propriété sn_atf.page_data_capture.enabled système pour actualiser la liste des composants de la page chaque fois qu’une étape de test d’interface utilisateur personnalisée est exécutée. L’activation de cette propriété pendant la conception du test garantit que vos concepteurs de test ont toujours accès à la liste la plus récente des composants de page. La désactivation de cette propriété une fois la conception du test terminée permet à vos tests de s’exécuter plus rapidement, car les étapes de test peuvent utiliser la liste précédemment récupérée des composants de page.
Traite ServiceNow AI Platform la liste des composants de page récupérés comme des données et ne les inclut pas dans les ensembles de mises à jour ou les fichiers d’application. Lors du transfert de tests d’une instance à une autre, les concepteurs de tests doivent à nouveau récupérer manuellement les composants de page.
Considérations relatives à la conception
Suivez ces considérations de conception lorsque vous testez des pages d’interface utilisateur et des composants de page personnalisés.
- Utiliser l’inspecteur de page pour identifier les composants de page pouvant être testés
- L’inspecteur de page détermine les composants de page disponibles pour le test d’interface utilisateur personnalisé. Les composants de page qui ne sont pas disponibles pour l’inspecteur de page ne sont pas disponibles pour les tests d’interface utilisateur personnalisés.
- Accédez à l’interface utilisateur personnalisée que vous souhaitez tester
- Utilisez les étapes de test existantes pour accéder à l’interface utilisateur personnalisée cible. Par exemple, pour tester un article de la base de connaissances, utilisez les étapes de test existantes pour accéder à un module ou pour ouvrir un enregistrement existant. La plupart des tests d’interface utilisateur personnalisés nécessitent l’utilisation de catégories d’étapes de test existantes dans le cadre du test.
- Utilisez la zone de composant pour identifier les composants de la page
- La zone de composant décrit l’élément de mise en page HTML contenant le composant tel qu’un
<div>élément ou<section>. La zone aide les concepteurs de test à distinguer les composants en fournissant l’emplacement dans la mise en page. - Tester votre interface utilisateur personnalisée plutôt qu’une ServiceNow AI Platform interface utilisateur
- Cela Framework de tests automatisés empêche le test d’interface utilisateur personnalisé des ServiceNow AI Platform fonctionnalités. Par exemple, vous ne pouvez pas tester les tableaux de bord ou les graphistes. Au lieu de cela, créez des tests pour valider vos pages et éléments d’interface utilisateur personnalisés, car vous avez un contrôle direct sur ces interfaces utilisateur.
- Utiliser des attributs HTML pour remplacer les propriétés de test des composants de la page
- Modifiez les propriétés de test d’un composant de page particulier à l’aide d’attributs HTML spécifiques à Framework de tests automatisés. Consultez Remplacer les actions de test du composant.
- Récupérer à nouveau les composants de page lorsque vous déplacez les tests vers une autre instance
- Les étapes de test d’interface utilisateur personnalisées ne stockent pas les composants de l’interface utilisateur en tant que métadonnées. Les testeurs doivent à nouveau récupérer manuellement les composants de page lors du déplacement des tests entre les instances.
Exemple de test d’interface utilisateur personnalisée
Vous pouvez utiliser la liste des composants récupérés pour concevoir des étapes de test d’interface utilisateur personnalisées. Par exemple, supposons que vous souhaitiez tester la révision et le commentaire d’un article de la base de connaissances. Un article de la base de connaissances contient plusieurs composants de page qui nécessitent des étapes d’interface utilisateur personnalisées pour être testés.
- Nombre de vues de l’article.
- Boutons permettant de marquer l’article comme utile.
- La zone de texte pour laisser un commentaire.
- Accédez au module. Accédez au module « Publié » dans l’application « Base de connaissances ».
- Ouvrez un enregistrement existant. Ouvrez le formulaire « Base de connaissances » avec l’ID « Base de connaissances : KB0011110 ».
- Cliquez sur une action d’interface utilisateur. Cliquez sur l’action d’interface utilisateur « Afficher l’article » sur le formulaire « Base de connaissances ».
- Déclarer le texte sur la page (interface utilisateur personnalisée). Vérifiez que le texte « développeurs » est sur la page.
- Définir les valeurs de composant (interface utilisateur personnalisée). Définissez les composants sur la page comme suit : 'Zone de texte <textarea> [article_comments]' = Mettre à jour avec l’article réel plutôt que l’URL vers un article ailleurs.
- Cliquer sur composant (interface utilisateur personnalisée). Cliquez sur le composant : « Bouton <button>: Commentaire ».
- Déclarer le texte sur la page (interface utilisateur personnalisée). Affirmez que le texte « Mettre à jour avec l’article réel plutôt que l’URL vers l’article ailleurs » est sur la page.
Version et ordre des composants d’interface utilisateur personnalisés
Lorsque vous sélectionnez un composant dans l’une des étapes de test d’interface utilisateur personnalisée, la version d’interface utilisateur personnalisée peut apparaître. S’il y a plusieurs composants en double, l’ordre des composants s’affiche.
- La version de l’interface utilisateur personnalisée s’affiche uniquement s’il existe au moins deux composants différents avec des versions d’interface utilisateur personnalisées différentes.
- L’ordre s’affiche uniquement s’il y a des composants en double dans le menu déroulant du composant. Vous pouvez les désambiguïser en fonction de l’ordre affiché.
- La version d’interface utilisateur personnalisée et l’ordre s’affichent tous deux s’il existe plusieurs composants en double de différentes versions.
Identification des composants
<button sn-atf-id="consistentValue">Test</button>Améliorer l’identification des composants ATF
Identifiez votre composant à l’aide du chemin d’accès de l’étiquette inclus dans la colonne Zone de page . Depuis la mise en Rome production, la propriété sn_atf.element.use_label_path est définie sur vrai par défaut.
Si un composant possède l’attribut sn-atf-area , la colonne Zone de page affiche la valeur sn-atf-area . Si l’attribut sn-atf-area n’est pas présent, le chemin d’accès de l’étiquette de ce composant est affiché dans la colonne Zone de page.
sn-atf-area ou de chemin d’accès à l’étiquette, la valeur est affichée par défaut.Lorsque vous sélectionnez le composant requis dans la liste et que vous cliquez sur Soumettre, la description de l’étape de test est également mise à jour avec plus de détails.