Power BI ビジュアルの並べ替えオプション

この記事では、Power BI の視覚エフェクトで項目を並べ替える方法の指定に使用できるさまざまなオプションについて説明します。

capabilities.json ファイルに特に明記されていない限り、既定では、ビジュアルで並べ替え順序の変更はサポートされません。

"並べ替え" 機能を利用するには、少なくとも次のいずれかのパラメーターが必要です。

• default
• implicit
• custom

既定の並べ替え

default オプションは最も単純な形式です。 ユーザーは任意の 1 つのフィールドと方向 (昇順または降順) に従って並べ替えができます。 ユーザーは [その他のオプション] メニューから方向とフィールドを選びます。

既定の並べ替えを有効にするには、capabilities.json ファイルに次のコードを追加します。

    "sorting": {
        "default": {   }
    }

暗黙的な並べ替え

暗黙的な並べ替えでは、パラメーター clauses を使って、各データ ロールの並べ替えを記述した並べ替え配列を事前に定義できます。 ユーザーは並べ替えの順序を変更できないため、Power BI では視覚エフェクトのメニューに並べ替えのオプションが表示されません。 ただし、Power BI では、指定された設定に従ってデータが並べ替えられます。

暗黙的な並べ替えを有効にするには、implicit の clauses を capabilities.json ファイルに追加します。clauses パラメーターには、それぞれ 2 つのパラメーターを持つ複数のオブジェクトを含めることができます。

• role:並べ替える DataMapping を決定します
• direction:並べ替えの方向を決定します (1 = 昇順、2 = 降順)

    "sorting": {
        "implicit": {
            "clauses": [
                {
                    "role": "category",
                    "direction": 1
                },
                {
                    "role": "measure",
                    "direction": 2
                }
            ]
        }
    }

カスタム並べ替え

カスタム並べ替えにより、開発者は並べ替えを柔軟に行えます。 開発者は次のことができます。

• ユーザーが一度に複数のフィールドで並べ替えることができるようにします。
• データの既定の並べ替え順序を設定する
• 実行時にカスタム並べ替え操作を許可する

カスタム並べ替えを有効にする

カスタム並べ替えを有効にするには、capabilities.json ファイルに次のコードを追加します。

    "sorting": {
        "custom": {} 
    }

例: カスタム並べ替え API

let queryName1 = this.dataView.matrix.columns.levels[0].sources[0].queryName;
let queryName2 = this.dataView.matrix.columns.levels[1].sources[0].queryName;
let args: CustomVisualApplyCustomSortArgs = {
    sortDescriptors: [
        {
            queryName: queryName1,
            sortDirection: powerbi.SortDirection.Ascending
        },
        {
            queryName: queryName2,
            sortDirection: powerbi.SortDirection.Descending
        },
    ]
};
this.host.applyCustomSort(args);

関連するコンテンツ

• Power BI ビジュアルでのデータ ビューのマッピングについて理解する
• 機能について