Catégorie Application Navigator

  • Rversion finale: Zurich
  • Mis à jour 31 juil. 2025
  • 16 minutes de lecture
  • Vérifiez la fonctionnalité des menus et des modules dans le navigateur d’applications.

    Visibilité du menu de l'application

    Vérifie la visibilité, ou l’absence de visibilité, des menus d’applications sélectionnés dans le navigateur d’applications (barre de navigation de gauche). Par exemple, vous créez un test qui emprunte d’abord l’identité d’un utilisateur, puis vérifie que les menus d’application spécifiés (tels que Libre-service et Rapports) sont visibles, ou non, pour cet utilisateur.

    Tableau 1. Entrées
    Champ Description
    Ordre d'exécution Entier spécifiant l’ordre dans lequel le test exécute cette étape.

    Au fur et à mesure que vous créez des étapes, le système attribue automatiquement une valeur incrémentielle à chaque étape. Cette valeur entraîne l’exécution des étapes par le test dans l’ordre dans lequel vous les avez créées. Vous pouvez modifier cet ordre par défaut en modifiant les valeurs d’ordre d’exécution .

    Actif Option permettant d’activer cette étape de test pour utilisation.
    Application Périmètre de l’application dans lequel le système exécute ce test ou cette suite de tests.
    Test Nom en lecture seule du test auquel vous ajoutez l’étape.
    Configuration de l'étape Nom en lecture seule de l’étape.
    Description Description de l’étape de test. Cette valeur de champ est automatiquement définie en fonction des valeurs de champ de l’étape de test. Ce champ s’affiche une fois l’étape de test soumise.
    Notes Notes sur l’étape de test.
    Navigateur Version du navigateur par rapport à laquelle effectuer l’assertion
    • Interface utilisateur principale (UI16) : Si vous créez de nouvelles étapes, vous disposez Interface utilisateur principale de la valeur par défaut.
    • Next Experience: si vous l’avez Next Experience activé, Next Experience il s’agit du navigateur par défaut. S’il est désactivé, Interface utilisateur principale c’est le navigateur par défaut.
    Type de déclaration visible Spécifie comment la visibilité des menus d’applications sélectionnés dans le champ Menus d’applications visibles doit être testée dans le navigateur d’applications.
    • Au moins ces menus d’application sont visibles : au minimum, tous les menus d’application sélectionnés sont visibles dans le navigateur d’application.
    • Seuls ces menus d’application sont visibles : seuls les menus d’application sélectionnés sont visibles dans le navigateur d’application.
    Menus d'applications visibles Menus d’applications dont la visibilité dans le navigateur d’applications est en cours de vérification.
    Type de déclaration non visible Spécifie comment les menus d’applications sélectionnés dans le champ Menus d’applications non visibles doivent être testés pour détecter leur manque de visibilité dans le navigateur d’applications.
    • Au moins ces menus d’application ne sont pas visibles : au minimum, tous les menus d’application sélectionnés ne sont pas visibles dans le navigateur d’application.
    • Seuls ces menus d’application ne sont pas visibles : seuls les menus d’application sélectionnés ne sont pas visibles dans le navigateur d’application.
    Menus d'applications non visibles Menus d’applications dont le manque de visibilité dans le navigateur d’applications est en cours de vérification.

    Créer un menu d’application

    Les menus d’application définissent le contenu principal auquel les utilisateurs peuvent accéder dans le navigateur d’applications. Vous pouvez configurer les applications qui s’affichent dans le navigateur d’applications.

    Avant de commencer

    Rôle requis : admin

    Pourquoi et quand exécuter cette tâche

    Lors de la création d’un menu d’application, envisagez de regrouper des modules similaires dans un menu d’application consolidé. Lors de la modification d’un menu existant, ajoutez d’autres modules utiles au menu de l’application et supprimez ceux qui ne sont pas nécessaires.

    Procédure

    1. Accédez à la Tout > Définition du système > Menus d'application.
    2. Cliquez sur Nouveau.
    3. Complétez le formulaire.
      Champ Description
      Titre Définit le nom d’affichage du menu d’application.
      Rôles Limite l’accès aux rôles spécifiés. Tous les utilisateurs peuvent afficher le menu d’application lorsqu’il est actif.
      Catégorie Spécifie la catégorie de menu qui définit le style de menu de navigation (la valeur par défaut est Applications personnalisées).
      Conseil Définit le texte qui s’affiche dans une info-bulle lorsqu’un utilisateur pointe sur ce menu d’application.
      Actif Cochez la case pour activer le menu d’application. Seuls les menus d’application actifs s’affichent dans le navigateur d’applications.
      Description Fournissez une explication plus détaillée de ce que fait cette application.
      Autres champs
      Ordre Définit la position relative du menu d’application dans le navigateur d’application. Si vous ne spécifiez pas d’ordre, l’ordre par défaut de la catégorie de menu est utilisé.
      Type d'équipement par défaut Ce champ n’est pas utilisé. Vous pouvez définir des menus d’application pour les appareils mobiles dans une table distincte.
      Remarque :
      Vous devrez peut-être configurer le formulaire pour voir tous les champs.
    4. Cliquez sur Envoyer.
    5. Créez des modules à afficher dans le menu de l’application.
      Seuls les menus d’application contenant des modules s’affichent dans le navigateur d’applications.

    Créer un module

    Les modules sont les options de navigation de deuxième niveau vers les applications dans le navigateur d’applications. Les modules sont souvent liés à d’autres pages ou enregistrements de la plateforme. Vous pouvez configurer les modules qui s’affichent dans le navigateur d’applications à l’aide du module Menus d’application.

    Regardez cette vidéo de cinq minutes pour en savoir plus sur l’ajout de menus et de modules d’application au navigateur d’application.

    Avant de commencer

    Rôle requis : admin

    Procédure

    1. Ouvrez l’enregistrement du menu d’application en utilisant l’une des méthodes suivantes.
      • Accédez à la Définition du système > Menus d'application et sélectionnez le menu d’application dans la liste.
      • Accédez au menu d’application et cliquez sur l’icône Modifier l’application (crayon).
      Figure 1. Deux méthodes pour créer un module
      GIF montrant la première et la deuxième méthode de création d’un module
    2. Faites défiler la page vers le bas jusqu’à la liste connexe Modules et cliquez sur Nouveau.
    3. Définissez le module en remplissant les champs du formulaire Module.
      Tableau 2. Formulaire de module
      Champ Description
      Titre Définit le nom du module. Choisissez un titre qui identifie clairement le module.
      Menu d'application Spécifie le nom du menu d’application sous lequel le module apparaît.
      Conseil Définit l’info-bulle qui s’affiche lorsqu’un utilisateur pointe sur le nom du module.
      Remarque :
      Les indicateurs de module sont déconseillés dans Interface utilisateur principale
      Ordre Ordre dans lequel le module s’affiche par rapport à d’autres modules.
    4. Dans l’onglet Visibilité , renseignez les champs.
      Tableau 3. Onglet Visibilité
      Champ Description
      Rôles Limite l’accès au module aux rôles spécifiés. Si ce champ est laissé vide, le module est visible par tous les utilisateurs qui ont accès au menu de l’application.
      Actif Définit si le module apparaît dans le navigateur d’applications.
      Remplacer les rôles du menu d'application Permet aux utilisateurs d’accéder à ce module même s’ils n’ont pas l’autorisation d’afficher le menu d’application conteneur. Les utilisateurs doivent toujours répondre aux besoins de rôle pour ce module.
    5. Sous l’onglet Type de liste , renseignez les champs.

      Les champs affichés dépendent du type de lien que vous choisissez. Tous les URI de module doivent être codés. Si vous fournissez des arguments à l’URI du module, vous ou ServiceNow. Pour plus d’informations sur le codage des URI de module, consultez Codage des URI de module.

      Tableau 4. Onglet Type de liste
      Champ Description
      Type de lien Spécifie le type de lien ouvert par ce module. Vous devez spécifier des informations supplémentaires en fonction du type de lien. Voir Types de liens de module.
      Table Spécifie la table utilisée par le module.
      Remarque :
      La liste affiche uniquement les tables et les vues de base de données qui sont dans le même champ d’application que le module.
      Filtre Conditions pour les éléments présentés dans le module, par exemple, Actif est vrai.
      Argument Chaîne ajoutée à l’URI pour créer l’URI du module. Peut être un sysparm_query. Ces valeurs doivent être codées soit par vous, soit ServiceNowpar . Pour plus d’informations sur le codage des URI de module, consultez Codage des URI de module.
      Ordre Spécifie l’ordre dans lequel les modules apparaissent sous l’application.

    Types de liens de module

    Le champ Type de lien du formulaire Module spécifie le type de lien que le module ouvre.

    Tableau 5. Types de liens de module
    Type de lien Description
    Évaluation Liens vers l’enquête basée sur l’évaluation que vous sélectionnez dans le champ de référence Évaluation . Voir Créer un module d’enquête.
    Page de contenu Affiche la page de contenu que vous sélectionnez dans le champ de référence de la page de contenu . Voir Création d’une page de contenu.
    Lien vers la documentation Lien vers une page de documentation et s’ouvre dans un nouvel onglet ou une nouvelle fenêtre. Ce type de lien est utilisé avec les métadonnées incorporées dans les rubriques de documentation. Pour ouvrir un document interne à partir d’un module, utilisez le type de lien du module URL (à partir des arguments).
    Page d'accueil Affiche la page d’accueil que vous sélectionnez dans le champ de référence de la page d’accueil .
    HTML (depuis Arguments) Place le HTML dans le navigateur d’applications. Ce type de lien est utilisé pour les liens plus compliqués, où une URL plate n’est pas assez personnalisable.
    Remarque :
    • Le type de lien HTML (à partir des arguments) est pris en charge uniquement dans les interfaces UI15 et UI11 héritées. Dans Interface utilisateur principale, utilisez plutôt le type de lien URL (à partir des arguments).
    • Entrez une valeur pour le champ Arguments .
    Filtre de liste Affiche une vue de liste non remplie pour la table que vous sélectionnez dans le champ Table . Permet aux utilisateurs de spécifier un filtre sans charger la liste au préalable. Utilisez le champ Filtre pour définir le filtre par défaut de la liste. Utilisez le champ Nom de la vue pour spécifier une gestion des vues.
    Liste des enregistrements Affiche la vue de liste de la table que vous sélectionnez dans le champ Table . Utilisez le champ Filtre pour définir le filtre par défaut de la liste. Utilisez le champ Nom de la vue pour spécifier une vue.
    Page de carte Affiche la page de carte que vous sélectionnez dans le champ de référence de la page de carte .
    Nouvel enregistrement Affiche un formulaire de création d’enregistrement dans la table que vous sélectionnez dans le champ Table .
    Exécuter un rapport Exécute le rapport enregistré que vous sélectionnez dans le champ Rapport .
    Script (à partir des arguments) Exécute un script, tel que défini dans le champ Arguments .
    Remarque :
    Entrez une valeur pour le champ Arguments .
    Écran de recherche Lien qui affiche un formulaire vide pour rechercher des enregistrements dans la table. Utilisez le champ Nom de la vue pour spécifier une vue.
    Remarque :
    Utilisez le paramètre &sysparm_result_view=view_name pour définir la vue dans laquelle les résultats sont rendus.

    Toutes les recherches utilisent une requête [commence par] pour rechercher du texte correspondant. Les autres types de requête ne sont pas pris en charge dans les écrans de recherche.

    Séparateur Crée une division entre les modules. Entrez un nom dans le champ Titre pour ajouter un nom de section que les utilisateurs peuvent réduire ou développer.
    Enregistrement unique Affiche un formulaire pour un seul enregistrement dans la table. Utilisez le champ Nom de la vue pour spécifier une vue.
    Enquête Liens vers l’enquête héritée que vous sélectionnez dans le champ de référence Enquête . Utilisez la case à cocher Remplacer l’enquête pour déterminer si l’enquête peut être effectuée plusieurs fois.
    Remarque :
    Le type de lien d’enquête est destiné à être utilisé uniquement avec les enquêtes héritées, que les enquêtes basées sur l’évaluation remplacent. Sélectionnez le type de lien Évaluation pour lier le module à une enquête basée sur des évaluations.
    Page de chronologie Affiche la page de chronologie que vous sélectionnez dans le champ de référence Page de chronologie . Voir Pages de chronologie.
    URL (depuis Arguments) Ouvre n’importe quelle URL, telle que définie dans le champ Arguments .

    [Facultatif] Utilisez le champ Nom de fenêtre pour définir un lien qui s’ouvre dans une nouvelle fenêtre.

    Remarque :
    • Pour les liens internes, utilisez toujours un lien relatif tel que ./catalog_home.do ?sysparm_view=catalog_default ou catalog_home.do ?sysparm_view=catalog_default. N’utilisez pas un lien absolu vers une ServiceNow instance. Cela crée des problèmes lorsque vous déplacez un ensemble de mises à jour d’une instance de développement vers une instance de production, car l’URL fait toujours référence à l’instance de développement.
    • Entrez une valeur pour le champ Arguments .

    Codage des URI de modules

    Cliquez sur le nom d’un module dans le volet de navigation pour exécuter un URI qui ouvre la page du module dans le volet de contenu. Tous les caractères des URI de module doivent être encodés URL, sinon le lien est rompu.

    Remarque :
    Si vous effectuez une mise à niveau vers la version New York ou une version ultérieure à partir d’une version antérieure à New York, les interfaces utilisateur de vos modules peuvent ne pas fonctionner si elles ne respectent pas les conventions présentées dans cette rubrique.

    Lorsque vous créez des modules, vous avez la possibilité d’ajouter des arguments et des conditions de filtre qui trient et/ou réduisent le nombre de résultats affichés dans le volet de contenu. Lorsque vous cliquez sur un nom de module dans Définitions des systèmes > Définitions d’applications, vous pouvez voir ces conditions et arguments sous l’onglet Type de lien .

    Onglet Type de lien

    La définition de l’argument dans Arguments et les conditions de filtre définies dans Filtre font partie de l’URI du module et doivent être codées URL. ServiceNow encode automatiquement l’URL des conditions de filtre et les ajoute à l’URI du module à l’aide de sysparm_query. Par exemple, l’ajout de la condition de filtre, Active is true ajoute sysparm_query=active %3Dtrue à l’URI du module ; %3D est le codage d’URL pour le signe égal (=).

    Le tableau suivant indique quand vous devez coder l’argument par URL dans le champ Arguments et quand ServiceNow l’argument est encodé par URL.

    Tableau 6. Règles de codage des arguments
    A une condition de filtre ? La définition de l’argument commence par Qui encode l’argument ? Comment un argument est traité
    Non ^

    ServiceNow

    Supprime le caret (^) de l’argument, le code et utilise sysparm_query pour l’ajouter à l’URI du module.
    Non & Vous Supprime l’esperluette (&) de l’argument et l’ajoute à l’URI du module.
    Non Autre chose ServiceNow Code l’argument et utilise sysparm_query pour l’ajouter à l’URI du module.
    Oui ^ ServiceNow Codage URL de la définition du filtre et de l’argument et utilise sysparm_query pour ajouter la combinaison à l’URI du module.
    Oui Autre chose Vous URL encode la définition de filtre et utilise sysparm_query pour l’ajouter avec les arguments (non modifiés) à l’URI du module.

    Vous pouvez activer (la valeur par défaut) et désactiver l’exigence de codage d’URL pour les interfaces utilisateur de module à l’aide de la glide.ui.encode_module_uri propriété.

    Exemples

    Les exemples suivants montrent quand vous devez coder la définition d’argument par URL dans Arguments :
    • Il n’y a pas de conditions de filtre et la définition de l’argument dans Arguments commence par une esperluette et, par exemple,&sysparm_fixed_query=assigned_to=javascript :gs.user_id().

      Cet argument interrompt l’URI du module car le signe égal et les deux points ne sont pas encodés en URL, et l’esperluette empêche ServiceNow l’argument d’encoder l’URL. Encodez l’URL de l’argument : &sysparm_fixed_query=assigned_to %3Djavascript %3Ags.user_id().

    • Il y a des conditions de filtre et la définition de l’argument dans Arguments ne commence pas par un caret (^), par exemple, sysparm_name=Barnes & Noble’s.

      Cet argument casse l’URI du module car les esperluettes et les espaces ne sont pas encodés URL. URL encode l’argument : sysparm_name=Barnes %20%26%20Nobel’s

    Visibilité du module

    Vérifiez la visibilité, ou l’absence de visibilité, des modules sélectionnés dans le navigateur d’applications (barre de navigation de gauche). Par exemple, créez un test qui emprunte d’abord l’identité d’un utilisateur, puis vérifie que les modules spécifiés (tels que Page d’accueil et Mes demandes) sont visibles, ou non, pour cet utilisateur.

    Tableau 7. Entrées
    Champ Description
    Ordre d'exécution Entier spécifiant l’ordre dans lequel le test exécute cette étape.

    Au fur et à mesure que vous créez des étapes, le système attribue automatiquement une valeur incrémentielle à chaque étape. Cette valeur entraîne l’exécution des étapes par le test dans l’ordre dans lequel vous les avez créées. Vous pouvez modifier cet ordre par défaut en modifiant les valeurs d’ordre d’exécution .

    Actif Option permettant d’activer cette étape de test pour utilisation.
    Application Périmètre de l’application dans lequel le système exécute ce test ou cette suite de tests.
    Test Nom en lecture seule du test auquel vous ajoutez l’étape.
    Configuration de l'étape Nom en lecture seule de l’étape.
    Description Description de l’étape de test. Cette valeur de champ est automatiquement définie en fonction des valeurs de champ de l’étape de test. Ce champ s’affiche une fois l’étape de test soumise.
    Notes Notes sur l’étape de test.
    Navigateur Version du navigateur par rapport à laquelle effectuer l’assertion
    • Interface utilisateur principale (UI16) : Si vous créez de nouvelles étapes, vous disposez Interface utilisateur principale de la valeur par défaut.
    • Next Experience: si vous l’avez Next Experience activé, Next Experience il s’agit du navigateur par défaut. S’il est désactivé, Interface utilisateur principale c’est le navigateur par défaut.
    Type de déclaration visible Spécifie comment les modules sélectionnés dans le champ Modules visibles doivent être testés pour la visibilité dans le navigateur d’application.
    • Au moins ces modules sont visibles : au minimum, les modules sélectionnés dans le champ Modules visibles sont visibles dans le navigateur d’application.
    • Seuls ces modules sont visibles : seuls les modules spécifiques sélectionnés dans le champ Modules visibles sont visibles dans le navigateur d’application.
    Modules visibles Modules dont la visibilité dans le navigateur d’applications est en cours de vérification.
    Type de déclaration non visible Spécifie comment les modules sélectionnés dans le champ Modules non visibles doivent être testés pour détecter leur manque de visibilité dans le navigateur d’application.
    • Au moins ces modules ne sont pas visibles : au minimum, les modules sélectionnés dans le champ Modules non visibles ne sont pas visibles dans le navigateur d’application.
    • Seuls ces modules ne sont pas visibles : seuls les modules spécifiques sélectionnés dans le champ Modules non visibles ne sont pas visibles dans le navigateur d’application.
    Modules non visibles Modules dont le manque de visibilité dans le navigateur d’applications est en cours de vérification.

    Accéder au module

    Ouvrez un module à partir du navigateur d’application, comme si un utilisateur avait cliqué dessus. Le module doit être visible par l’utilisateur exécutant pour y accéder.

    Remarque :
    Toutes les pages ne sont pas testables actuellement. Où que le module vous mène, c’est votre responsabilité.
    Tableau 8. Entrées
    Champ Description
    Ordre d'exécution Entier spécifiant l’ordre dans lequel le test exécute cette étape.

    Au fur et à mesure que vous créez des étapes, le système attribue automatiquement une valeur incrémentielle à chaque étape. Cette valeur entraîne l’exécution des étapes par le test dans l’ordre dans lequel vous les avez créées. Vous pouvez modifier cet ordre par défaut en modifiant les valeurs d’ordre d’exécution .

    Actif Option permettant d’activer cette étape de test pour utilisation.
    Délai Nombre de secondes autorisées avant l’échec de l’étape. Si la validation échoue, le système répète l’étape jusqu’à ce qu’elle atteigne la durée du délai d’expiration. Si la validation échoue après l’expiration du délai d’expiration, l’étape échoue.
    Application Périmètre de l’application dans lequel le système exécute cette étape.
    Test Nom en lecture seule du test auquel vous ajoutez l’étape.
    Configuration de l'étape Nom en lecture seule de l’étape.
    Description Description de l’étape de test. Cette valeur de champ est automatiquement définie en fonction des valeurs de champ de l’étape de test. Ce champ s’affiche une fois l’étape de test soumise.
    Notes Notes sur l’étape de test.
    Module Module qui doit être ouvert. Pour accéder au module sélectionné, le module doit être visible par l’utilisateur exécutant dans le navigateur d’applications.
    Les modules suivants ne sont pas pris en charge et ne peuvent pas être testés :
    • Les modules qui sont des séparateurs
    • Modules qui ne sont pas liés à une page spécifique, mais qui exécutent du JavaScript côté client (tels que Studio et le débogueur de script)
    • Modules qui établissent des liens à des sites web externes, tels que le site de documentation ServiceNow (servicenow.com/docs)
    • Modules qui rechargent ou redirigent la totalité de la page