Partilhar via


API de detalhamento

A API de detalhamento permite criar um visual que pode disparar uma operação de detalhamento 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 detalhamento, consulte Suporte a detalhamento.

Como usar a API de detalhamento

Nota

A API de detalhamento está disponível na versão 4.7.0 da API Para descobrir qual versão você está usando, verifique a apiVersionno arquivo pbiviz.json .

Adicione o seguinte ao ficheiro capabilities.json :

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

Exemplo: API de detalhamento

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

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