Anwendungsmenü-API – ServiceNow Fluent

  • Freigeben Version: Zurich
  • Aktualisiert 31. Juli 2025
  • 1 Minute Lesedauer

    • Die Anwendungsmenü-API definiert Menüs im Anwendungsnavigator [sys_App_Application].

    Allgemeine Informationen zu Anwendungsmenüs finden Sie unter Erstellen Sie ein Anwendungsmenü.

    ApplicationMenu-Objekt

    Erstellen Sie ein Menü für eine Anwendung [sys_App_Application].

    Tabelle : 1. Eigenschaften
    Name Typ Beschreibung
    $ID Zeichenfolge oder Zahl Erforderlich. Eine eindeutige ID für das Metadatenobjekt. Wenn Sie die Anwendung erstellen, wird diese ID in eine eindeutige sys_ID gehasht Weitere Informationen finden Sie unter ServiceNow Fluent Sprachkonstrukte.

    Format: Now.ID['Zeichenfolge' oder Zahl]

    title Zeichenfolge Erforderlich. Die Bezeichnung für das Menü im Anwendungsnavigator.
    aktiv Boolean Kennzeichnung, die angibt, ob das Menü im Anwendungsnavigator angezeigt wird.
    Gültige Werte:
    • Wahr: Das Menü wird angezeigt.
    • Falsch: Das Menü ist ausgeblendet.

    Standardwert: wahr
    Rollen Array Eine Liste von Variablenbezeichnern von Rolle Objekte oder Namen von Rollen, die auf zugreifen können Menü. Weitere Informationen finden Sie unter Rollen-API – ServiceNow Fluent.
    Kategorie Referenz Der Variablenbezeichner einer Menükategorie [sys_App_category], die den Stil des Navigationsmenüs definiert. Verwenden Sie zum Definieren einer Menükategorie Datensatz-API – ServiceNow Fluent.

    Allgemeine Informationen zu Menükategorien finden Sie unter Customize menu categories.
    Tipp Zeichenfolge Eine kurze Beschreibung des Menüs, das als Tooltip angezeigt wird, wenn der Mauszeiger darüber bewegt wird.
    Beschreibung Zeichenfolge Zusätzliche Informationen darüber, was die Anwendung tut.
    Name Zeichenfolge Ein interner Name zur Unterscheidung zwischen Anwendungen mit demselben Titel.
    Reihenfolge Nummer Die relative Position des Anwendungsmenüs im Anwendungsnavigator.

    Standard: 100
    $Meta Objekt Metadaten für die Anwendungsmetadaten.
    Mit InstallMethod Eigenschaft können Sie die Anwendungsmetadaten einem Ausgabeverzeichnis zuordnen, das nur unter bestimmten Umständen geladen wird.
    $meta: {
      installMethod: 'String'
}
    Gültige Werte für InstallMethod :
    • Demo: Gibt die Anwendungsmetadaten an aus Metadaten/unload.demo Verzeichnis, das mit der Anwendung installiert werden soll, wenn Demodaten laden Option ist ausgewählt.
    • Erste Installation: Gibt die Anwendungsmetadaten an aus Metadaten/Entladen Verzeichnis, das nur bei der ersten Installation einer Anwendung auf einer Instanz installiert werden soll.
    		 
    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,
})
    Die referenzierte Kategorie wird mit definiert Datensatz Objekt:
    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;',
   },
})