API do menu da aplicação - ServiceNow Fluent

  • Versão de lançamento: Zurich
  • Atualizado 31 de jul. de 2025
  • 2 min. de leitura

    • A API do menu da aplicação define menus no navegador da aplicação [sys_app_application].

    Para obter informações gerais sobre menus da aplicação, consulte Criar um menu de aplicação.

    Objeto ApplicationMenu

    Crie um menu para uma aplicação [sys_app_application].

    Tabela 1. Propriedades
    Nome Tipo Descrição
    id Cadeia de caracteres ou número Necessário. Um ID exclusivo para o objeto de metadados. Quando você cria a aplicação, este ID é hash em um sys_id exclusivo. Para obter mais informações, consulte ServiceNow Fluent construções de linguagem.

    Formato: Now.ID['Cadeia de caracteres' ou número]

    título Cadeia de caracteres Necessário. O rótulo do menu no navegador de aplicações.
    ativo Booliano Sinalizador que indica se o menu aparece no navegador da aplicação.
    Valores válidos:
    • Verdadeiro: O menu é exibido.
    • Falso: O menu está oculto.

    Padrão: verdadeiro
    funções Matriz Uma lista de identificadores de variáveis de Função objetos ou nomes de funções que podem acessar o. menu. Para obter mais informações, consulte API de função - ServiceNow Fluent.
    categoria Referência O identificador de variável de uma categoria de menu [sys_app_category] que define o estilo do menu de navegação. Para definir uma categoria de menu, use API de registro - ServiceNow Fluent.

    Para obter informações gerais sobre categorias de menu, consulte Customize menu categories.
    dica Cadeia de caracteres Uma descrição resumida do menu que é exibido como dica de ferramenta ao passar o mouse sobre ele.
    descrição Cadeia de caracteres Informações adicionais sobre o que a aplicação faz.
    nome Cadeia de caracteres Um nome interno para diferenciar entre aplicações com o mesmo título.
    pedido Número A posição relativa do menu da aplicação no navegador da aplicação.

    Padrão: 100
    meta Objeto Metadados dos metadados da aplicação.
    Com o. Método de instalação , você pode mapear os metadados da aplicação para um diretório de saída que carrega somente em circunstâncias específicas.
    $meta: {
      installMethod: 'String'
}
    Valores válidos para Método de instalação :
    • Demonstração: Gera os metadados da aplicação para o. metadados/unload.demo diretório a ser instalado com a aplicação quando Carregar dados de demonstração a opção está selecionada.
    • Primeira instalação: Gera os metadados da aplicação para o. metadados/descarregamento diretório a ser instalado somente na primeira vez que uma aplicação for instalada em uma instância.
    		 
    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,
})
    A categoria referenciada é definida usando Registro objeto:
    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;',
   },
})