Podokno Analýza ve vizuálech Power BI

Podokno Analýza umožňuje do vizuálů přidat dynamické referenční čáry, jako je minimum, maximum nebo průměr. Tyto řádky vám můžou pomoct přiblížit důležité trendy nebo přehledy. Tento článek popisuje, jak vytvořit vizuály Power BI, které můžou prezentovat a spravovat dynamické referenční čáry v podokně Analýza .

Poznámka:

Podokno Analýza je dostupné v rozhraní API verze 2.5.0. Pokud chcete zjistit, kterou verzi používáte, podívejte se do apiVersionsouboru pbiviz.json .

Správa podokna Analýza

Správa vlastností v podokně Analýza se podobá správě vlastností v podokně Formát. Objekt definujete v souboru capabilities.json vizuálu.

V podokně Analýza je objekt definován takto:

Rozhraní API 5.1 nebo novější

Pod definici objektu přidejte pouze název objektu, název vlastnosti a typ, jak je vysvětleno zde. Příklad:

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

Starší rozhraní API (před 5.1)

1. Pod definici objektu přidejte displayName pole s objectCategory hodnotou 2.

   Poznámka:

   Pole objectCategory definuje aspekt vizuálu, který objekt řídí (1=Formátování, 2=Analýza). Používá se Formatting pro prvky, jako je vzhled a chování, barvy, osy a popisky. Slouží Analytics pro prvky, jako jsou prognózy, referenční čáry a obrazce.

   objectCategory Pokud tato hodnota není zadaná, je výchozí hodnota Formatting.

2. Do objektu přidejte následující dvě vlastnosti:

   • show typu bool s výchozí hodnotou true
   • displayName typu text s výchozí hodnotou 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
      }
    }
  ...
  }
}

Na kartě nastavení formátování určete, že tato karta patří do podokna analýzy nastavením parametru set card analyticsPane na truehodnotu . Ve výchozím nastavení analyticsPane je parametr false a karta se přidá do podokna formátování. Projděte si následující implementace:

Použití nástrojů 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];
}

Bez nástrojů 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],
          }]
      };

Definujte další vlastnosti stejným způsobem jako u objektů Format a výčty objektů stejně jako v podokně Formát .

Poznámka:

• Podokno Analýza používejte pouze pro objekty, které přidávají nové informace nebo odkládají nové světlo na prezentované informace (například dynamické referenční čáry, které ilustrují důležité trendy).
• Všechny možnosti, které řídí vzhled a chování vizuálu (tj. formátování), by měly být omezené na podokno Formátování .

Úvahy a omezení

• Podokno Analýza zatím nepodporuje více instancí. Jediný selektor , který objekt může mít, je statický (tj selector: null. ) a vizuály Power BI nemůžou mít více instancí uživatelem definované karty.
• Vlastnosti typu integer se nezobrazují správně. Jako alternativní řešení použijte místo toho typ numeric .

Související obsah

Přidání podmíněného formátování