アプリケーションメニュー API - ServiceNow Fluent

  • リリースバージョン: Zurich
  • 更新日 2025年07月31日
  • 所要時間：3分

    • アプリケーションメニュー API は、アプリケーションナビゲーター [sys_app_application] のメニューを定義します。

    アプリケーションメニューに関する一般的な情報については、「 アプリケーションメニューの作成」を参照してください。

    ApplicationMenu オブジェクト

    アプリケーション [sys_app_application] のメニューを作成します。

    表 : 1. プロパティ
    名前 タイプ 説明
    $id 文字列または数値 必須。メタデータオブジェクトの一意の ID。アプリケーションをビルドすると、この ID は一意のsys_idにハッシュされます。詳細については、「ServiceNow Fluent 言語構成」を参照してください。

    形式: Now.ID['string' or number]
    title 文字列 必須。アプリケーションナビゲーターのメニューのラベル。
    active ブーリアン アプリケーションナビゲーターにメニューが表示されるかどうかを示すフラグ。
    有効な値：
    • true：メインメニューが表示されます。
    • false：メニューは非表示です。

    デフォルト：true
    roles アレイ ものにアクセスできるロールオブジェクトの変数識別子またはロールの名前のリスト メニュー。 詳細については、「ロール API - ServiceNow Fluent」を参照してください。
    category 参照 ナビゲーションメニューのスタイルを定義するメニューカテゴリ [sys_app_category] の変数識別子。メニューカテゴリを定義するには、レコード API - ServiceNow Fluent を使用します。

    メニューカテゴリの一般的な情報については、「Customize menu categories」を参照してください。
    hint 文字列 メニューにカーソルを合わせるとツールヒントとして表示されるメニューの簡単な説明。
    説明 文字列 アプリケーションの機能に関する追加情報。
    name 文字列 同じタイトルのアプリケーションを区別するための内部名。
    order 番号 アプリケーションナビゲーター内のアプリケーションメニューの相対位置。

    デフォルト：100
    $meta オブジェクト アプリケーションメタデータのメタデータ。
    installMethod プロパティを使用すると、特定の状況でのみロードされる出力ディレクトリにアプリケーションメタデータをマップできます。
    $meta: {
      installMethod: 'String'
}
    installMethod の有効な値:
    • demo:[デモデータのロード] オプションが選択されている場合、アプリケーションメタデータを metadata/unload.demo ディレクトリに出力して、アプリケーションとともにインストールします。
    • 初回インストール:アプリケーションがインスタンスに初めてインストールされたときにのみインストールされるように 、アプリケーションメタデータをメタデータ/アンロード ディレクトリに出力します。
    		 
    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,
})
    参照されるカテゴリは、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;',
   },
})