リスト API - ServiceNow Fluent

  • リリースバージョン: Zurich
  • 更新日 2025年07月31日
  • 所要時間:2分
  • リスト API は、テーブルのリストビュー [sys_ui_list] を定義します。

    リストに関する一般的な情報については、「 ServiceNow AI Platform® list administration」を参照してください。

    List オブジェクト

    リスト [sys_ui_list] とそのビューを構成します。

    表 : 1. プロパティ
    名前 タイプ 説明
    table 文字列 必須。リストが適用されるテーブルの名前。
    表示 参照または文字列 必須。適用される UI ビュー [sys_ui_view] の変数識別子または名前、またはデフォルトビュー。

    UI ビューを定義するには、「 レコード API - ServiceNow Fluent」を参照してください。

    デフォルトのビュー (default_view) を使用するには、次の方法でインポートする必要があります。
    import { default_view } from '@servicenow/sdk/core'
    columns アレイ 必須。リストに表示するテーブルの列のリスト。リスト内の列名と位置を使用して指定されます。
    $meta オブジェクト アプリケーションメタデータのメタデータ。
    installMethod プロパティを使用すると、特定の状況でのみロードされる出力ディレクトリにアプリケーションメタデータをマップできます。
    $meta: {
          installMethod: 'String'
    }
    installMethod の有効な値:
    • demo:[デモデータのロード] オプションが選択されている場合、アプリケーションメタデータを metadata/unload.demo ディレクトリに出力して、アプリケーションとともにインストールします。
    • 初回インストール:アプリケーションがインスタンスに初めてインストールされたときにのみインストールされるように 、アプリケーションメタデータをメタデータ/アンロード ディレクトリに出力します。
    import { List } from "@servicenow/sdk/core";
    
    List({
        $id: Now.ID["app_task_view_list"],
        table: "cmdb_ci_server",
        view: app_task_view,
        columns: [
            { element: "name", position: 0 },
            { element: "business_unit", position: 1 },
            { element: "vendor", position: 2 },
            { element: "cpu_type", position: 3 },
        ],
    });
    
    参照される UI ビューの定義は、Record オブジェクトを使用して定義されます。
    import { Record } from "@servicenow/sdk/core";
    
    const app_task_view = Record({
       $id: Now.ID['app_task_view'],
       table: 'sys_ui_view',
       data: {
            name: 'app_task_view',
            title: 'app_task_view'
       }
    })