ダッシュボードメッセージハンドラー

  • リリースバージョン: Xanadu
  • 更新日 2024年08月01日
  • 所要時間:4分
  • インタラクティブ フィルターのカスタム フィルター ロジックを定義するメソッドを提供します。

    インタラクティブ フィルターの詳細については、「 レポートインタラクティブ フィルター」を参照してください。

    DashboardMessageHandler - DashboardMessageHandler(文字列 ID)

    特定の一意の ID を使用して、DashboardMessageHandler オブジェクトのインスタンスを作成します。

    表 : 1. パラメーター
    名前 タイプ 説明
    ID 文字列 フィルターの一意の ID。レポートウィジェットでこの ID を使用して、どのフィルターがどのフィルターに適用されたのかを追跡できます。ID はすべてのダッシュボードで一意である必要はありませんが、各ダッシュボードで同じ ID を持つ複数のフィルターを使用することはできません。
    var my_dashboardMessageHandler = new DashboardMessageHandler("my_unique_id");

    DashboardMessageHandler - publishFilter(文字列 table, 文字列 encodedQuery)

    DashboardMessageHandler オブジェクトは、それぞれ 1 つずつフィルターを公開できます。

    同じオブジェクトから新しいフィルターを公開すると、元のフィルターが上書きされます。複数のフィルターを公開するには、複数の DashboardMessageHandler オブジェクトを使用します。

    表 : 2. パラメータ
    名前 タイプ 説明
    table 文字列 フィルターを適用するテーブル (タスクなど)。
    encodedQuery 文字列 公開するフィルターを指定するエンコードされたクエリー。
    表 : 3. 返される内容
    タイプ 説明
    なし
    var my_dashboardMessageHandler = new DashboardMessageHandler("my_unique_id");
    <input id="onlyMine" type="button" value="Only mine"    onclick="my_dashboardMessageHandler.publishFilter('task','caller_idDYNAMIC90d1921e5f510100a9ad2572f2b477fe');"/>

    DashboardMessageHandler - publishMessage (配列フィルター)

    カスタムインタラクティブフィルターを複数のテーブルに適用します。

    表 : 4. パラメーター
    名前 タイプ Description (説明)
    フィルター アレイ フィルタリングするテーブルとフィルター基準を定義するフィルターオブジェクトのアレイ。
    [
      {
        "table": String,
        "filter": String 
      }
    ]
    filters.table 文字列 フィルタリングするテーブルの名前。
    filters.filter 文字列 テーブルに適用するフィルター基準を含むエンコードされたクエリ。
    表 : 5. 返される内容
    タイプ 説明
    なし

    この Jelly スクリプトは、インシデントテーブルと問題テーブルをフィルタリングして、アサイン先グループが [問題解決] であるレコードを返します。

    <?xml version="1.0" encoding="utf-8" ?>
    <j:jelly trim="false" xmlns:j="jelly:core" xmlns:g="glide" xmlns:j2="null" xmlns:g2="null">
    <script>
     var dmh = new DashboardMessageHandler("aha_dmh");
     var filter = "cmdb_ci.sys_idINcdafbfc9db8f570466e0a345ca96198a"; 
     //this is the encoded query string
     var fullFilter = dmh.getFilterMessage('change_request',filter); 
     //creates a JSON object
    
     SNC.canvas.interactiveFilters.setDefaultValue({id: dmh.aha_dmh, filters:[fullFilter],}, false);
     var published = dmh.publishMessage([fullFilter]);
    </script>
    
    </j:jelly>

    DashboardMessageHandler - removeFilter()

    この DashboardMessageHandler オブジェクトによって公開されている現在のフィルターを、ダッシュボード上のすべてのレポートから削除します。

    表 : 6. パラメーター
    名前 タイプ 説明
    なし
    表 : 7. 返される内容
    タイプ 説明
    なし
    var my_dashboardMessageHandler = new DashboardMessageHandler("my_unique_id");
    <input id="removeFilter" type="button" value="Remove filter"    onclick="my_dashboardMessageHandler.removeFilter();"/>