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.

Nota

Tabla analýzy je dostupná v rozhraní API verzie 2.5.0. Ak chcete zistiť, ktorú verziu používate, pozrite si apiVersion v súbore pbiviz.json.

Spravovanie tably Analýza

Spravovanie vlastností na table Analýza je podobné ako spravovanie vlastností na table Format. objekt môžete definovať v súbore capabilities.json vizuálu.

Pre tablu Analýza je objekt definovaný takto:

rozhrania 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 a pole objectCategory s hodnotou 2.

   Nota

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

   Ak objectCategory hodnota nie je zadaná, predvolene sa 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ýzy nastavením parametra set card analyticsPane na true. V predvolenom nastavení je parameter analyticsPane 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átovať a vyčíslite objekty rovnako ako na table Format.

Nota

• Tablu Analýza používajte iba pre objekty, ktoré pridávajú nové informácie alebo vnáša 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 prostredie 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, môže objekt mať, je statický (t. j. selector: null) 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 namiesto toho použite typ numeric.

Súvisiaci obsah

Pridanie podmieneného formátovania