API du menu d’application : ServiceNow Fluent

  • Rversion finale: Xanadu
  • Mis à jour 1 août 2024
  • 1 minute de lecture
  • L’API de menu d’application inclut des objets qui définissent les menus dans le navigateur d’applications [sys_app_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 fourni au format suivant, où <valeur> est une chaîne ou un nombre.
    $id: Now.ID[<value>]

    Lorsque vous créez l’application, cet ID est haché dans un sys_ID unique.

    Titre Chaîne Requis. L’étiquette du menu dans le navigateur d’applications.
    Actif Booléen Marqueur indiquant si le menu apparaît dans le navigateur d’application.
    Valeurs valides :
    • true : le menu s’affiche.
    • false : le menu est masqué.

    Valeur par défaut : true

    roles Tableau Une liste d’identificateurs variables d’objets de rôle ou de noms de rôles pouvant accéder au menu. Pour plus d'informations, consultez API de 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 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 Texte d’info-bulles qui s’affiche lorsqu’un utilisateur survole le menu.
    description Chaîne Informations supplémentaires sur ce que fait l’application
    nom Chaîne Nom interne permettant de différencier les applications portant le même titre.
    order Numéro Position relative du menu d’application dans le navigateur d’application.

    Par défaut : 100

    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;',
       },
    })