Tabla Analýza vo vizuáloch Power BI

Tabla Analýza umožňuje pridať do vizuálov dynamické referenčné čiary, ako je napríklad minimum, maximum alebo priemer. Tieto čiary vám pomôžu priblížiť dôležité trendy alebo prehľady. V tomto článku sa popisuje postup vytvárania vizuálov Power BI, ktoré môžu prezentovať a spravovať dynamické referenčné čiary na table Analýza .

Poznámka

Tabla Analýza je k dispozícii v rozhraní API verzie 2.5.0. Ak chcete zistiť, ktorú verziu používate, pozrite si apiVersionsúbor pbiviz.json .

Spravovanie tably Analýza

Spravovanie vlastností na table Analýza je podobné ako spravovanie vlastností na table Formát. Objekt definujete v súbore capabilities.json vizuálu.

V prípade tably Analýza je objekt definovaný takto:

API 5.1+

Do definície objektu pridajte iba názov objektu, názov vlastnosti a typ, ako je vysvetlené tu. Príklad:

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

Staršie rozhrania API (pred 5.1)

1. Do definície objektu pridajte displayName pole a objectCategory s hodnotou 2.

   Poznámka

   Pole objectCategory definuje aspekt vizuálu, ktorý daný objekt ovláda (1=Formátovanie, 2=Analýza). Použite Formatting pre prvky, ako je vzhľad a vzhľad, farby, osi a označenia. Použite Analytics pre prvky, ako sú napríklad prognózy, referenčné čiary a tvary.

   objectCategory Ak hodnota nie je zadaná, nastaví sa predvolene na Formatting.

2. Pridajte do objektu nasledujúce dve vlastnosti:

   • show typu bool s predvolenou hodnotou: true
   • displayName typu text s predvolenou 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 karte nastavení formátovania zadajte, že táto karta patrí do tably Analýza nastavením parametra set card analyticsPane na true. V predvolenom analyticsPane nastavení je parameter false a karta sa pridá na tablu formátovania. Pozrite si tieto implementácie:

Používanie pomôcok 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];
}

Bez pomôcok 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],
          }]
      };

Ostatné vlastnosti definujte rovnakým spôsobom ako v prípade objektov formátu a vyčíslite objekty rovnako ako na table Formát .

Poznámka

• Tablu Analýza používajte iba pre objekty, ktoré pridávajú nové informácie alebo vnášajú nové svetlo na prezentované informácie (napríklad dynamické referenčné čiary, ktoré ilustrujú dôležité trendy).
• Všetky možnosti, ktoré ovládajú vzhľad a dojem z vizuálu, čiže formátovanie, by mali byť obmedzené na tablu Formátovanie .

Dôležité informácie a obmedzenia

• Tabla Analýza zatiaľ nemá žiadnu podporu pre viacero inštancií . Jediný selektor, ktorý môže objekt mať, selector: nullje statický (t. j. ) a vizuály Power BI nemôžu mať viaceré inštancie karty definovanej používateľom.
• Vlastnosti typu integer sa nezobrazujú správne. Ako alternatívne riešenie použite namiesto toho typ numeric .

Súvisiaci obsah

Pridanie podmieneného formátovania