ダッシュボードコンポーネントイベント

  • リリースバージョン: Australia
  • 更新日 2026年03月12日
  • 所要時間：4分

    • イベントハンドラーを選択して、ダッシュボードコンポーネントで提供されるアクション (イベント) を構成します。

    [イベント] タブには、ダッシュボードコンポーネントで使用されるイベントが表示されます。利用可能なイベントを表示するには、[ + イベントマッピングを追加] を選択します。リスト内のイベントを選択して、1 つ以上のイベントハンドラーを追加します。

    イベントハンドラー

    イベントハンドラーはデータリソースと連携して、ユーザーに表示するデータにダッシュボードアクションをリンクします。リスト内のイベントを選択して、1 つ以上のイベントハンドラーを追加します。

    イベントの説明

    イベント 説明
    ダッシュボードの概要ページに移動 ダッシュボードが閉じられ、ダッシュボードライブラリにリダイレクトされるとディスパッチされます。この動作をカスタマイズするには、[ダッシュボードリストにリダイレクト (Redirect to dashboard list)] クライアントスクリプトのルートとタイトルを変更します。クライアントスクリプトを開くには、ページのサイドバーにある<>アイコンを選択します。
    * @param {params} params
* @param {api} params.api
* @param {any} params.event
* @param {any} params.imports
* @param {ApiHelpers} params.helpers
*/
function handler({api}) {
    api.emit('SCREEN_STATUS_CHANGED', {status: 'closed'});
    api.emit('NAV_ITEM_SELECTED', {
        route: 'dashboard-library',
        title: 'Dashboard Library',
    });
}
    ダッシュボードウィジェットがクリックされました
    ダッシュボードの可視化がクリックされたときのカスタム動作でデフォルトのドリルダウンを上書きする場合は、このイベントハンドラーを追加します。ダッシュボードウィジェットクリッククライアントスクリプトを使用します。カスタムドリルダウンを追加するには:
    1. defaultDrilldowns プロパティを false に設定します。
    2. [ダッシュボードウィジェットがクリックされました] イベントハンドラーを追加します。
    3. ダッシュボードウィジェットがクリックされたクライアントスクリプトを開きます。クライアントスクリプトを開くには、ページのサイドバーにある<>アイコンを選択します。
    4. コード api.emit('NAV_ITEM_SELECTED', payload); を見つけ、カスタムリダイレクトロジックに合わせて ペイロード を更新します。
    URL パラメーターの更新が要求されました

    ダッシュボードコンポーネントが通常 URL パラメーターを更新し、 delegateUrlParams が true であるたびにディスパッチされます。このイベントは、クライアントスクリプトがカスタムナビゲーションロジックを実装するために使用できる構造化パラメーターデータを提供します。

    URL パラメーター:
    • sysId:移動先のダッシュボードのsys_id。ダッシュボードが変更されたときに表示されます。
    • tabSysId:選択したタブのsys_id。タブが変更されたときに存在します。
    • edit:ダッシュボードが編集モードかどうか。編集モードが変更されたときに表示されます。
    すべてのパラメーターには、次のオブジェクトフィールドがあります。
    • value (string | boolean):パラメーター値
    • description (文字列):パラメーターの分かりやすい説明
    sysId パラメーターには、次のオブジェクトフィールドもあります。
    • dashboardName (文字列):ダッシュボードのタイトル
    • isNewTab (ブーリアン):ユーザーがダッシュボードピッカーで Cmd/Ctrl+クリックまたは中央クリックを実行した場合に true 。新しいタブで開く意図を示します。sysId パラメーターに対してのみ送信されます。
    例：
    {
  "urlParams": {
    "sysId": {
      "value": "a1b2c3d4e5f6",
      "dashboardName": "Dashboard A",
      "description": "Dashboard sys_id",
      "isNewTab": false
    },
    "tabSysId": {
      "value": "f6e5d4c3b2a1",
      "description": "Tab sys_id"
    },
    "edit": {
      "value": true,
      "description": "Edit mode"
    }
  }
}

    詳細については、「ダッシュボード URL パラメーターの委任」を参照してください。

    注:
    この機能には、ServiceNow® Storeの最新のプラットフォームアナリティクスエクスペリエンスアプリケーションが必要です。