Analytiikka-ruutu Power BI:n visualisoinneissa

Analytiikka- avulla voit lisätä visualisointeihin dynaamisia viiteviivoja, kuten minimi, maksimi tai keskiarvo. Näiden rivien avulla voit lähentää tärkeitä trendejä tai merkityksellisiä tietoja. Tässä artikkelissa kerrotaan, miten voit luoda Power BI -visualisointeja, jotka voivat esittää ja hallita dynaamisia viiteviivoja Analytics -ruudussa.

Muistiinpano

Analytics -ruutu on saatavilla ohjelmointirajapinnan versiossa 2.5.0. Voit selvittää käyttämäsi version pbiviz.json tiedoston apiVersion.

Analytiikka-ruudun hallinta

Ominaisuuksien hallinta Analytiikka -ruudussa muistuttaa ominaisuuksien hallintaaMuotoile -ruudussa. Voit määrittää visualisoinnin capabilities.json tiedostoon -objektin.

Analytics ruudussa objekti määritetään seuraavasti:

API 5.1+

Lisää objektin määritelmässä vain objektin nimi, ominaisuuden nimi ja tyyppi esitetyllä tavalla, tässä. Esimerkki:

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

vanhemmat ohjelmointirajapinnat (ennen 5.1:tä)

1. Lisää objektin määritelmässä displayName ja objectCategory -kenttä, jonka arvo on 2.

   Muistiinpano

   objectCategory-kenttä määrittää visualisoinnin aspektin, jota objekti valvoo (1 = muotoilu, 2 = analytiikka). Käytä Formatting ulkoasun, värien, akseleiden ja otsikoiden kaltaisten elementtien kohdalla. Käytä Analytics elementeille, kuten ennusteille, viiteviivoille ja muodoille.

   Jos objectCategory-arvoa ei ole määritetty, sen oletusarvo on Formatting.

2. Lisää seuraavat kaksi ominaisuutta objektiin:

   • show tyyppiä bool, oletusarvo on true
   • displayName tyyppiä text, oletusarvo on 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
      }
    }
  ...
  }
}

Määritä Muotoiluasetukset-kortissa, että tämä kortti kuuluu analytiikkaruutuun, määrittämällä set card analyticsPane parametrin arvoksi true. Oletuksena analyticsPane parametri on epätosi ja kortti lisätään muotoiluruutuun. Katso seuraavat toteutukset:

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

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

Määritä muita ominaisuuksia samalla tavalla kuin Muotoilu- objekteja ja luettele objekteja samalla tavalla kuin Muotoile -ruudussa.

Muistiinpano

• Käytä Analytiikka -ruutua vain objekteille, jotka lisäävät uusia tietoja tai valaisevat uusia tietoja (esimerkiksi dynaamisia viiteviivoja, jotka kuvaavat tärkeitä trendejä).
• Kaikki asetukset, jotka ohjaavat visualisoinnin ulkoasua (eli muotoilua), on rajoitettava muotoiluruudun .

Huomioitavat asiat ja rajoitukset

• Analytics -ruudussa ei ole vielä usean esiintymän tukea. Ainoa valitsin, objektilla voi olla, on staattinen (eli selector: null), eikä Power BI:n visualisoinneilla voi olla useita käyttäjän määrittämän kortin esiintymiä.
• integer tyyppisiä ominaisuuksia ei näytetä oikein. Voit kiertää ongelman käyttämällä sen sijaan tyyppiä numeric.

Aiheeseen liittyvä sisältö

Ehdollisen muotoilun lisääminen