API du menu d’application : ServiceNow Fluent

  • Rversion finale: Zurich
  • Mis à jour 31 juil. 2025
  • 2 minutes de lecture

    • L’API Application Menu définit les menus dans le navigateur d’applications [sys_app_application].

    Pour des informations générales sur les menus d’application, reportez-vous à la section Créer un menu d’application.

    Objet ApplicationMenu

    Créer un menu pour une application [sys_app_application].

    Tableau 1. Propriétés
    Nom Type Description
    $id Chaîne ou numéro Requis. ID unique pour l’objet de métadonnées. Lorsque vous créez l’application, cet ID est haché en une sys_id unique. Pour en savoir plus, consultez ServiceNow Fluent Constructions linguistiques.

    Format : Now.ID['chaîne' ou numéro]
    Titre Chaîne Requis. Étiquette du menu dans le navigateur d’applications.
    actif Booléen Marqueur indiquant si le menu apparaît dans le navigateur d’applications.
    Valeurs valides :
    • true : le menu apparaît.
    • false : le menu est masqué.

    Par défaut : true
    roles Tableau Liste des identificateurs de variables d’objets de rôle ou de noms de rôles pouvant accéder au menu. Pour en savoir plus, consultez API du rôle : ServiceNow Fluent.
    catégorie Référence Identificateur de variable d’une catégorie de menu [sys_app_category] qui définit le style de menu de navigation. Pour définir une catégorie de menu, utilisez le fichier API d’enregistrement : ServiceNow Fluent.

    Pour des informations générales sur les catégories de menu, reportez-vous à la section Customize menu categories.
    hint Chaîne Une brève description du menu qui s’affiche sous forme d’info-bulle lorsque vous le survolez.
    description Chaîne Informations supplémentaires sur ce que fait l’application.
    nom Chaîne Nom interne pour différencier les applications portant le même titre.
    order Numéro Position relative du menu d’application dans le navigateur d’applications.

    Par défaut : 100
    $meta Objet Métadonnées pour les métadonnées de l’application.
    Avec la propriété installMethod , vous pouvez mapper les métadonnées d’application à un répertoire de sortie qui ne se charge que dans des circonstances spécifiques.
    $meta: {
      installMethod: 'String'
}
    Valeurs valides pour installMethod :
    • demo : génère les métadonnées de l’application dans le répertoire metadata/unload.demo à installer avec l’application lorsque l’option Charger les données de démonstration est sélectionnée.
    • première installation : génère les métadonnées de l’application dans le répertoire metadata/unload à installer uniquement la première fois qu’une application est installée sur une instance.
    		 
    import { ApplicationMenu } from "@servicenow/sdk/core";

ApplicationMenu({
   $id: Now.ID['my_app_menu'],
   title: 'My App Menu',
   hint: 'This is a hint',
   description: 'This is a description',
   category: appCategory,
   roles: ['admin'],
   active: true,
})
    La catégorie référencée est définie à l’aide de l’objet Record :
    import { Record } from "@servicenow/sdk/core";

export const appCategory = Record({
   table: 'sys_app_category',
   $id: Now.ID[9],
   data: {
      name: 'example',
      style: 'border-color: #a7cded; background-color: #e3f3ff;',
   },
})