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

  • リリースバージョン: Yokohama
  • 更新日 2025年01月30日
  • 所要時間:2分
  • アプリケーションメニュー API には、アプリケーションナビゲーター [sys_app_application] のメニューを定義するオブジェクトが含まれています。

    ApplicationMenu オブジェクト

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

    表 : 1. プロパティ
    名前 タイプ 説明
    $id 文字列または数値 必須。次の形式で提供されるメタデータオブジェクトの一意の ID。ここで、<value> は文字列または数値です。
    $id: Now.ID[<value>]

    アプリケーションをビルドすると、この ID は一意の sys_ID にハッシュされます。

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

    デフォルト:true

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

    メニューカテゴリの一般的な情報については、「Customize menu categories」を参照してください。

    hint 文字列 ユーザーがメニューにカーソルを合わせたときに表示されるツールヒントテキスト。
    description 文字列 アプリケーションの機能に関する追加情報。
    name 文字列 同じタイトルのアプリケーションを区別するための内部名。
    order 番号 アプリケーションナビゲーター内のアプリケーションメニューの相対位置。

    デフォルト: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,
    })
    参照されるカテゴリは、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;',
       },
    })