É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 Framework de tests automatisés les composants pouvant être testés à partir d’une page Web cible.
Composants testables
Les composants de page testables se composent 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 depuis le 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 en 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, tels 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 Now Platform fonctionnalités.
- sont accessibles à l’inspecteur de page
- Les composants de page testables doivent renvoyer des résultats lorsqu’ils sont affichés à partir du fichier Inspecteur de page. Les concepteurs de tests peuvent utiliser l’inspecteur de page pour identifier les composants testables d’une page.
- 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 ne pouvant pas être testés.
| Motif non testable | Composants de page impossibles à tester |
|---|---|
| Ne sont pas définissables ni cliquables | 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 des DOM | Tableaux de bord |
| Images | |
| Listes | |
| Rapports | |
| DOM fantôme | |
| Sont inaccessibles à JavaScript | Fichiers Excel |
| Champs de fichier | |
| Fichiers PDF | |
| Sont Now 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 des champs de formulaire | |
| Catalogue de services | |
| Espaces de travail |
Composants de page définissables
Un composant pouvant être défini 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 de l’ID système.
- Date
- Date/Heure
- Référence
Consultez Remplacer le type de données de 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, par exemple des entrées de type case à cocher ou cases 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 du 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 tests 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 des composants de page précédemment récupérée.
Traite Now 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’applications. 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 les tests d’interface utilisateur personnalisés. 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.
- Utiliser 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 tests à distinguer les composants en fournissant l’emplacement dans la mise en page. - Tester votre interface utilisateur personnalisée plutôt que l’interface Now Platform utilisateur
- Cela Framework de tests automatisés empêche les tests d’interface utilisateur personnalisés des Now 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 de composants d’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 « 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 « 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 l’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ées, la version d’interface utilisateur personnalisée peut s’afficher. 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 la commande s’affichent s’il y a plusieurs composants en double de versions différentes.
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 true 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 à l’étiquette de ce composant est affiché dans la colonne Zone de page.
sn-atf-area ni de chemin d’accès d’étiquette, la valeur s’affiche 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.