分享方式：

向下鑽研 API

  • 文章

向下鑽研 API 讓您可以建立一個可自行觸發向下鑽研作業且無需使用者互動的視覺效果。

API 可讓視覺效果顯示下一個層級、展開至下一個層級，或根據傳遞至 API 的參數向上鑽研。 如需向下鑽研的詳細資訊，請參閱向下鑽研支援。

如何使用向下鑽研 API

注意

向下鑽研 API 可從 API 4.7.0 版取得，若要知道您使用的版本，請檢查 pbiviz.json 檔案中的 apiVersion。

在 capabilities.json 檔案中新增下列內容：

    "drilldown": {
        "roles": ["Rows", "Columns"]
    }

範例：向下鑽研 API

下列範例示範視覺效果如何呼叫向下鑽研作業。

public update(options: VisualUpdateOptions) {
        if ((options.dataViews[0].metadata.dataRoles.drillableRoles['Columns']).indexOf(powerbi.DrillType.Down) >= 0) {
            let args: powerbi.DrillDownArgs = {
                roleName: "Columns",
                drillType: powerbi.DrillType.Down
            };
            this.host.drill(args);
        }