Delen via


Inzoom-API

Met de Drilldown-API kunt u een visual maken waarmee een inzoombewerking zelfstandig kan worden geactiveerd, zonder tussenkomst van de gebruiker.

Met de API kan de visual het volgende niveau weergeven, uitbreiden naar het volgende niveau of inzoomen op basis van de parameters die aan de API zijn doorgegeven. Zie De ondersteuning voor inzoomen voor meer informatie over inzoomen.

De drilldown-API gebruiken

Notitie

De Drilldown-API is beschikbaar via API-versie 4.7.0 Om erachter te komen welke versie u gebruikt, controleert u het apiVersion bestand pbiviz.json .

Voeg het volgende toe aan het bestand capabilities.json :

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

Voorbeeld: Drilldown-API

In het volgende voorbeeld ziet u hoe de visual een inzoombewerking aanroept.

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