Het deelvenster Analyse in Power BI-visuals

Met het deelvenster Analytics kunt u dynamische referentielijnen, zoals min, max of gemiddeld, toevoegen aan uw visuals. Met deze lijnen kunt u inzoomen op belangrijke trends of inzichten. In dit artikel wordt beschreven hoe u Power BI-visuals maakt die dynamische referentielijnen kunnen presenteren en beheren in het deelvenster Analytics.

Notitie

Het deelvenster Analytics is beschikbaar in API-versie 2.5.0. Als u wilt achterhalen welke versie u gebruikt, controleert u de apiVersion in het bestand pbiviz.json.

Het deelvenster Analyse beheren

Het beheren van eigenschappen in het deelvenster Analytics is vergelijkbaar met de beheereigenschappen in het deelvenster Indeling. U definieert een -object in het capabilities.json-bestand van de visual.

Voor het deelvenster Analytics wordt het object als volgt gedefinieerd:

API 5.1+

Voeg onder de definitie van het object alleen de objectnaam, de eigenschapsnaam en het type toe, zoals hier wordt uitgelegd . Voorbeeld:

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

oudere API's (vóór 5.1)

1. Voeg onder de definitie van het object de displayName en een objectCategory veld toe met een waarde van 2.

   Notitie

   Het veld objectCategory definieert het aspect van de visual die door het object wordt beheerd (1=Format, 2=Analytics). Gebruik Formatting voor elementen zoals uiterlijk, kleuren, assen en labels. Gebruik Analytics voor elementen zoals prognoses, referentielijnen en vormen.

   Als de objectCategory waarde niet is opgegeven, wordt deze standaard ingesteld op Formatting.

2. Voeg de volgende twee eigenschappen toe aan het object:

   • show van het type bool met een standaardwaarde van true
   • displayName van het type text met een standaardwaarde van 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
      }
    }
  ...
  }
}

Geef in de kaart opmaakinstellingen op dat deze kaart deel uitmaakt van het analysedeelvenster door de parameter set card analyticsPane in te stellen op true. Standaard is parameter analyticsPane vals en de kaart wordt toegevoegd aan het opmaakvenster. Bekijk de volgende implementaties:

FormattingModel-utils gebruiken

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

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

Definieer andere eigenschappen op dezelfde manier als voor Opmaak objecten en inventariseer objecten net als in het deelvenster Opmaak.

Notitie

• Gebruik het deelvenster Analytics alleen voor objecten die nieuwe informatie toevoegen of nieuw licht werpen op de gepresenteerde informatie (bijvoorbeeld dynamische referentielijnen die belangrijke trends illustreren).
• Alle opties waarmee het uiterlijk van de visual, dat wil zeggen, opmaak, bepaald worden, moeten beperkt blijven tot het deelvenster Opmaak.

Overwegingen en beperkingen

• Het deelvenster Analytics heeft nog geen ondersteuning voor meerdere instellingen. De enige -selector die een object kan hebben, is statisch (dat wil zeggen, selector: null), en Power BI-visuals kunnen niet meerdere exemplaren van een door de gebruiker gedefinieerde kaart hebben.
• Eigenschappen van het type integer worden niet correct weergegeven. Als tijdelijke oplossing kunt u numeric in plaats daarvan gebruiken.

Verwante inhoud

voorwaardelijke opmaak toevoegen