API de drill down

A API de drilldown permite criar um visual que possa disparar uma operação de drilldown por conta própria, sem interação do usuário.

A API permite que o visual mostre o próximo nível, expanda para o próximo nível ou faça drill up com base nos parâmetros passados para a API. Para obter mais informações sobre como fazer drill down, veja Suporte a drill down.

Como usar a API de drilldown

Observação

A API de drill down está disponível a partir da versão 4.7.0. da API. Para descobrir qual versão você está usando, confira o apiVersion no arquivo pbiviz.json.

Adicione o seguinte ao arquivo capabilities.json:

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

Exemplo: API de drilldown

O exemplo a seguir mostra como o visual chama uma operação de drilldown.

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);
        }