Drilldown-API

Die Drilldown-API ermöglicht das Erstellen von Visuals, die einen Drilldownvorgang ohne Benutzerinteraktion selbst auslösen können.

Die API ermöglicht dem Visual basierend auf den Parametern, die an die API übergeben werden, die Anzeige der nächsten Ebene, das Erweitern auf die nächste Ebene oder einen Drillup. Weitere Informationen zum Ausführen von Drilldowns finden Sie unter Hinzufügen von Unterstützung für Drilldowns.

Verwenden der Drilldown-API

Hinweis

Die Drilldown-API ist ab der API-Version 4.7.0 verfügbar. Um herauszufinden, welche Version Sie verwenden, überprüfen Sie die apiVersion in der Datei pbiviz.json.

Fügen Sie der Datei capabilities.json Folgendes hinzu:

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

Beispiel: Drilldown-API

Im folgenden Beispiel wird gezeigt, wie das Visual einen Drilldownvorgang aufruft.

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