Volet Analytique des visuels Power BI

Le volet Analyse vous permet d’ajouter des lignes de référence dynamiques (min, max ou moyenne) à vos visuels. Ces lignes peuvent vous permettre d’effectuer un zoom avant sur des tendances ou des insights importants. Cet article explique comment créer des visuels Power BI qui peuvent présenter et gérer des lignes de référence dynamiques dans le volet Analytique.

Remarque

Le volet Analyse est disponible à compter de la version d’API 2.5.0. Pour savoir quelle version vous utilisez, consultez le apiVersion fichier pbiviz.json .

Gérer le volet Analytique

La gestion des propriétés dans le volet Analytique est similaire à la gestion des propriétés dans le volet Mise en forme. Vous définissez un objet dans le fichier capabilities.json du visuel.

Pour le volet Analytique, l’objet est défini comme suit :

API 5.1+

Sous la définition de l’objet, ajoutez uniquement le nom de l’objet, le nom de la propriété et le type, comme expliqué ici. Exemple :

{
  "objects": {
    "YourAnalyticsPropertiesCard": {
      "properties": {
        "show": {
          "type": {
            "bool": true
          }
        },
        "displayName": {
          "type": {
            "text": true
          }
        },
      ... //any other properties for your Analytics card
      }
    }
  ...
  }
}

API plus anciennes (avant la version 5.1)

1. Sous la définition de l’objet, ajoutez la valeur displayName et un champ objectCategory avec la valeur 2.

   Notes

   Le champ objectCategory définit l’aspect du visuel que l’objet contrôle (1=Mise en forme, 2=Analytique). Utilisez Formatting pour les éléments comme l’apparence, les couleurs, les axes et les étiquettes. Utilisez Analytics pour les éléments comme les prévisions, les lignes de référence et les formes.

   Si la valeur objectCategory n’est pas spécifiée, Formatting est sélectionné par défaut.

2. Ajoutez les deux propriétés suivantes à l’objet :

   • show de type bool, avec la valeur par défaut de true
   • displayName de type text, avec la valeur par défaut de true

{
  "objects": {
    "YourAnalyticsPropertiesCard": {
      "displayName": "Your analytics properties card's name",
      "objectCategory": 2,
      "properties": {
        "show": {
          "type": {
            "bool": true
          }
        },
        "displayName": {
          "type": {
            "text": true
          }
        },
      ... //any other properties for your Analytics card
      }
    }
  ...
  }
}

Dans la carte de paramètres de mise en forme, spécifiez que cette carte appartient au volet analytique en définissant le paramètre set card analyticsPane sur true. Par défaut, le paramètre analyticsPane est false et la carte est ajoutée au volet de mise en forme. Consultez les implémentations suivantes :

Utilisation des utilitaires FormattingModel

class YourAnalyticsCardSettings extends FormattingSettingsCard {
    show = new formattingSettings.ToggleSwitch({
        name: "show",
        displayName: undefined,
        value: false,
        topLevelToggle: true
    });

    displayNameProperty = new formattingSettings.TextInput({
        displayName: "displayName",
        name: "displayName",
        placeholder: "",
        value: "Analytics Instance",
    });

    name: string = "YourAnalyticsPropertiesCard";
    displayName: string = "Your analytics properties card's name";
    analyticsPane: boolean = true; // <===  Add and set analyticsPane variable to true 
    slices = [this.show, this.displayNameProperty];
}

Sans les utilitaires FormattingModel

      const show: powerbi.visuals.EnabledSlice = {
          uid: "enableAxisCard_topLevelToggle_show_uid",
          suppressDisplayName: true,
          control: {
              type: powerbi.visuals.FormattingComponent.ToggleSwitch,
              properties: {
                  descriptor: {
                      objectName: "YourAnalyticsPropertiesCard",
                      propertyName: "show"
                  },
                  value: false
              }
          }
      }
        
      const displayNameProperty: powerbi.visuals.FormattingSlice = {
          uid: "enableAxisCard_displayName_uid",
          suppressDisplayName: true,
          control: {
              type: powerbi.visuals.FormattingComponent.TextInput,
              properties: {
                  descriptor: {
                      objectName: "YourAnalyticsPropertiesCard",
                      propertyName: "displayName"
                  },
                  value: "Analytics Instance",
                  placeholder: ""
              }
          }
      }

      const averageLineCard: powerbi.visuals.FormattingCard = {
          displayName: "Your analytics properties card's name",
          uid: "yourAnalyticsCard_uid",
          analyticsPane: true, // <===  Add and set analyticsPane variable to true 
          topLevelToggle: show,
          groups: [{
              displayName: undefined,
              uid: "yourAnalyticsCard_group_uid",
              slices: [displayNameProperty],
          }]
      };

Définissez d’autres propriétés de la même façon que vous le faites pour mettre en forme les objets et énumérez les objets comme vous le faites dans le volet Format.

Notes

• Utilisez le volet Analytique uniquement pour les objets qui ajoutent de nouvelles informations ou qui donnent un nouvel éclairage aux informations présentées (par exemple, des lignes de référence dynamiques qui illustrent des tendances importantes).
• Les options qui contrôlent l’apparence du visuel (c’est-à-dire sa mise en forme) doivent être limitées au volet Mise en forme.

Considérations et limitations

• Le volet Analytique n’offre pas encore la prise en charge de plusieurs instances. Le seul sélecteur d’un objet est static (c’est-à-dire selector: null) et les visuels Power BI ne peuvent pas avoir plusieurs instances d’une carte définies par l’utilisateur.
• Les propriétés de type integer ne sont pas affichées correctement. Pour résoudre ce problème, il est conseillé d’utiliser plutôt le type numeric.

Étapes suivantes

Ajouter une mise en forme conditionnelle