API детализации

API детализации позволяет создавать визуальный элемент, который может запускать операцию детализации самостоятельно без взаимодействия с пользователем.

API позволяет визуальному элементу отображать следующий уровень, расширяться до следующего уровня или детализации на основе параметров, переданных API. Дополнительные сведения о детализации см. в разделе "Поддержка детализации".

Использование API детализации

Примечание.

API детализации доступен из API версии 4.7.0, чтобы узнать, какую версию вы используете, проверка apiVersion в файле pbiviz.json.

Добавьте следующее в файл 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);
        }