API d’exploration hiérarchique

L'API d’exploration hiérarchique vous permet de créer un visuel capable de déclencher une opération d'exploration de manière autonome, sans interaction avec l'utilisateur.

L’API permet au visuel d’afficher le niveau suivant, de se développer au niveau suivant ou d’explorer en fonction des paramètres passés à l’API. Pour plus d'informations sur l’exploration hiérarchique, consultez la section Support d’exploration hiérarchique.

Comment utiliser l’API d’exploration hiérarchique

Remarque

L’API d’exploration hiérarchique est disponible à partir de l’API version 4.7.0 Pour savoir quelle version vous utilisez, consultez le apiVersion dans le fichier pbiviz.json.

Ajoutez ceci dans le fichier capabilities.json :

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

Exemple : API d’exploration hiérarchique

L’exemple suivant montre comment le visuel appelle une opération d’exploration hiérarchique.

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