Riquadro Analisi negli oggetti visivi di Power BI

Il riquadro Analisi consente di aggiungere linee di riferimento dinamiche, ad esempio min, max o media, agli oggetti visivi. Queste righe consentono di ingrandire le tendenze importanti o le informazioni dettagliate. Questo articolo illustra come creare oggetti visivi di Power BI in grado di presentare e gestire linee di riferimento dinamiche nel riquadro Analisi.

Nota

Il riquadro Analisi è disponibile nell'API versione 2.5.0. Per scoprire quale versione si sta usando, archiviare apiVersion nel file pbiviz.json.

Gestire il riquadro Analisi

La gestione delle proprietà nel riquadro Analisi è simile alla gestione delle proprietà nel riquadro Formato. Definire un oggetto nel file di capabilities.json dell'oggetto visivo.

Per il riquadro Analisi, l'oggetto viene definito come segue:

API 5.1+

Nella definizione dell'oggetto aggiungere solo il nome dell'oggetto, il nome della proprietà e il tipo, come illustrato qui. Esempio:

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

API meno recenti (precedenti alla versione 5.1)

1. Nella definizione dell'oggetto aggiungere displayName e un campo objectCategory con il valore 2.

   Nota

   Il campo objectCategory definisce l'aspetto dell'oggetto visivo che controlla l'oggetto (1=Formattazione, 2=Analisi). Usare Formatting per elementi quali aspetto, colori, assi ed etichette. Usare Analytics per elementi quali previsioni, linee di riferimento e forme.

   Se il valore objectCategory non viene specificato, per impostazione predefinita è Formatting.

2. Aggiungere le due proprietà seguenti all'oggetto :

   • show di tipo bool, con il valore predefinito true
   • displayName di tipo text, con il valore predefinito 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
      }
    }
  ...
  }
}

Nella scheda delle impostazioni di formattazione specificare che questa scheda appartiene al riquadro Analisi impostando il parametro set card analyticsPane su true. Per impostazione predefinita, il parametro analyticsPane è false e la scheda verrà aggiunta al riquadro di formattazione. Vedere le implementazioni seguenti:

Uso di FormattingModel Utils

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

Senza FormattingModel Utils

      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],
          }]
      };

Definire altre proprietà nello stesso modo in cui si esegue per gli oggetti Format ed enumerare gli oggetti esattamente come si fa nel riquadro Formato.

Nota

• Usare il riquadro Analisi solo per gli oggetti che aggiungono nuove informazioni o fanno luce sulle informazioni presentate (ad esempio, le linee di riferimento dinamiche che illustrano tendenze importanti).
• Tutte le opzioni che controllano l'aspetto dell'oggetto visivo (ovvero la formattazione) devono essere limitate al riquadro Formattazione.

Considerazioni e limitazioni

• Il riquadro Analytics non supporta ancora più istanze. L'unico selettore che un oggetto può avere è statico (ovvero selector: null) e gli oggetti visivi di Power BI non possono avere più istanze di una scheda definita dall'utente.
• Le proprietà di tipo integer non vengono visualizzate correttamente. Come soluzione alternativa, usare invece il tipo numeric.

Contenuto correlato

Aggiungere la formattazione condizionale