Power BI:n mukautettujen visualisointien muotoiluruutu

Ohjelmointirajapinnan versiosta 5.1 alkaen kehittäjät voivat luoda visualisointeja, jotka käyttävät uutta Power Format -ruutua. Kehittäjät voivat määrittää kortit ja luokat mukautetun visualisointinsa mille tahansa ominaisuudelle, mikä helpottaa raporttien luojien näiden visualisointien käyttöä.

Uusi ohjelmointirajapinta mukauttaa muoto- ja analytiikkaruutujen osia FormattingModel -menetelmällä.

getFormattingModel palauttaa FormattingModel, joka määrittää visualisoinnin muotoilu- ja analytiikkaruudun ulkoasun.

Kaikkien vanhojen muotoiluruudun ominaisuuksien lisäksi uuden muotoilumallin tukee uusia muotoiluruudun ominaisuuksia, uusia ominaisuuksia ja uusia hierarkioita.

Luo visualisointi, joka tukee uutta muotoiluruutua

Yleiset vaiheet uuden muotoiluruudun tuen lisäämiseksi mukautettuun visualisointiin:

1. Määritä pbiviz.json-tiedoston apiVersion arvoksi 5.1 tai uudempi.

2. Määritä kaikki mukautettavat objectscapabilities.json-tiedostossa. Nämä objektit liitetään muotoiluruudun ominaisuuksiin. Kullekin objektille vaaditaan seuraavat ominaisuudet:

   • objektin nimi
   • ominaisuuden nimi
   • ominaisuuden tyyppi

   Kaikki muut ominaisuudet, mukaan lukien DisplayName ja description, ovat nyt valinnaisia.

3. Luo mukautettu visualisointi FormattingModel tekemällä yksi seuraavista:

   • Käytä formattingmodel util. (Suositeltu)
   • Käytä vain ohjelmointirajapintoja ilman tätä apuohjelmaa.

Määritä mukautetun visualisoinnin muotoilumallin ominaisuudet ja luo se koodilla (ei JSON:llä).

4. Ota getFormattingModel-ohjelmointirajapinta käyttöön mukautetussa visualisointiluokassa, joka palauttaa mukautetun visualisoinnin muotoilumallin. (Tämä ohjelmointirajapinta korvaa aiemmissa versioissa käytetyt enumerateObjectInstances).

Esimerkki mallin muotoilun toteutuksesta

• Muotoilumalli formattingmodel util esimerkissä. (Suositeltu)
• Mallin muotoileminen käyttämällä vain ohjelmointirajapintoja esimerkki.

Karttojen muotoiluominaisuudet

Jos sinulla on mukautettu visualisointi luotu vanhemmalla ohjelmointirajapinnalla ja haluat siirtyä uuteen muotoiluruutuun tai jos olet luomassa uutta mukautettua visualisointia:

1. Määritä pbiviz.json-tiedoston apiVersion arvoksi 5.1 tai uudempi.

2. Luo kullekin objektin nimelle ja ominaisuuden nimelle capabilities.jsonvastaava muotoiluominaisuus. Muotoilu-ominaisuudessa tulee olla kuvaaja, joka sisältää objectName ja propertyName, jotka vastaavat capabilities.jsonobjektin nimeä ja ominaisuuden nimeä.

Ominaisuustiedoston objects ominaisuudet ovat edelleen samassa muodossa, eikä niitä tarvitse muuttaa.

Jos esimerkiksi capabilities.json-tiedoston circle-objekti on määritetty seuraavasti:

"objects": {
    "circle": {
        "properties": {
            "circleColor": {
                "type": {
                    "fill": {
                        "solid": {
                            "color": true
                        }
                    }
                }
            },
        }
    }
}

Mallisi muotoiluominaisuuden on oltava tyyppiä ColorPicker ja se näyttää tältä:

control: {
    type: "ColorPicker",
    properties: {
        descriptor: {
            objectName: "circle",
            propertyName: "circleColor"
        },
        value: {
            value: this.visualSettings.circle.circleColor
        }
    }
}

Saat virheilmoituksen, jos jokin seuraavista ehdoista on tosi:

• Ominaisuustiedoston objektin tai ominaisuuden nimi ei vastaa muotoilumallin nimeä.
• Ominaisuustiedoston ominaisuustyyppi ei vastaa muotoilumallin tyyppiä

Muotoilumalli

Muotoilumallissa kuvailet ja mukautat muotoiluruudun kaikkia ominaisuuksia.

Mallin osien muotoilu

Uudessa muotoilumallissa ominaisuuden osat on ryhmitelty yhteen loogisten luokkien ja aliluokkien mukaan. Nämä ryhmät helpottavat mallin skannaamista. Peruskomponentteja on viidestä suurimmasta pienimpään:

• Muotoilumalli Ruudun suurimman säilön, jota käytetään ruudun edustaliittymän muotoiluun. Se sisältää luettelon muotoilukorteista.

• Muotoilukortti Ylätason ominaisuudet -ryhmittelysäilö ominaisuuksien muotoilua varten. Kukin kortti koostuu yhdestä tai useammasta muotoiluryhmästä, kuten tässä on esitetty.

  

• Muotoiluryhmän
  Toissijaisen tason ominaisuuksien ryhmittelysäilö. Muotoiluryhmä näytetään ryhmittelysäilönä osittajien muotoilua varten.

  

• Muotoilu-säilön
  Toissijaisen tason ominaisuuksien ryhmittelysäilö. Muotoilusäilöryhmät muotoilevat osittajat erillisiksi säilökohteiksi, ja niiden välillä voidaan vaihtaa avattavan luettelon avulla.

  

• Osittajan muotoilu
  Ominaisuussäilö. Osittoja on kahdenlaisia:

  • Yksinkertainen osittaja: Yksittäinen ominaisuussäilö
  • yhdistelmäosittajan: Useita liittyviä ominaisuussäilöjä ryhmiteltynä yhdeksi muotoiluosiksi

  Seuraavassa kuvassa näytetään erityyppiset osittajat. Fontti on yhdistelmäosa, joka koostuu fonttiperheestä, -koosta sekä lihavoidusta, kursivoitusta ja alleviivauskytkimestä. "Väri", "näyttöyksiköt" ja muut osittajat ovat yksinkertaisia sekstareita, joissa kussakin on yksi komponentti.

  

Visualisointiruudun muotoiluominaisuudet

Muotoilumallin jokaisen ominaisuuden on vastattava capabilities.json-tiedoston objektityyppiä.

Seuraavassa taulukossa näytetään capabilities.json tiedoston muotoilun ominaisuustyypit ja niiden vastaava tyyppiluokka moderneissa muotoilumallin ominaisuuksissa:

Objektien muotoiluominaisuudet

^* Luettelointiluettelon muotoiluominaisuus on erilainen muotoilumallissa ja ominaisuustiedostossa.

• Määritä seuraavat muotoiluasetusten luokan ominaisuudet, mukaan lukien luettelointikohteiden luettelo:

  • Kohteen avattava valikko
  • ItemFlagsSelection

• Määritä seuraavat ominaisuudet muotoiluasetusten luokassa ilman luettelointikohteiden luetteloa. Ilmoita niiden luettelointikohdeluettelo capabilities.json asianmukaisen objektin alla. (Nämä tyypit ovat samat kuin aiemmissa ohjelmointirajapintaversioissa):

  • Automaattinen avattava valikko
  • AutoFlagSelection

Yhdistelmäosittajan ominaisuudet

Yhdistelmäosittajan muotoilu on muotoiluosittaja, joka sisältää useita toisiinsa liittyviä ominaisuuksia yhdessä.

Nyt meillä on kaksi yhdistelmäosittajatyyppiä:

• FontControl
  Tämä pitää kaikki fontti liittyvät ominaisuudet yhdessä. Se koostuu seuraavista ominaisuuksista:

  • Fonttiperhe
  • Kirjasinkoko
  • Lihavointi [valinnainen]
  • Kursivoitu [valinnainen]
  • Underline [valinnainen]

  

  Kaikilla näillä ominaisuuksilla on oltava vastaava objekti ominaisuustiedostossa:

  Ominaisuus	Ominaisuustyyppi	Muotoilutyyppi
  Fonttiperhe	Muotoilu: { fontFamily}	FontPicker
  Kirjasinkoko	Muotoilu: {fontSize}	NumUpDown
  Rohkea	Bool	VaihdaSwitch
  Kursivoitu	Bool	VaihdaSwitch
  Alleviivata	Bool	VaihdaSwitch

• MarginPadding Reunuksen täyttö määrittää tekstin tasauksen visualisoinnissa. Se koostuu seuraavista ominaisuuksista:

  • Vasen
  • Oikea
  • Huippu
  • Pohja

  Kaikilla näillä ominaisuuksilla on oltava vastaava objekti ominaisuustiedostossa:

  Ominaisuus	Ominaisuustyyppi	Muotoilutyyppi
  Vasen	Numeerinen	NumUpDown
  Oikea	Numeerinen	NumUpDown
  Huippu	Numeerinen	NumUpDown
  Pohja	Numeerinen	NumUpDown

GitHub-resurssit

• Kaikki muotoilumallien käyttöliittymät löytyvät GitHub – microsoft/powerbi-visuals-api: Power BI:n mukautettujen visualisointien ohjelmointirajapinta kohteessa formatting-model-api.d.ts.

• Suosittelemme käyttämään uutta muotoilumallin apuohjelmaa osoitteessa GitHub – microsoft/powerbi-visuals-utils-formattingmodel: Power BI -visualisointien muotoilumallin apuohjelmat

• Löydät esimerkin mukautetusta visualisoinnista, SampleBarChart-, joka käyttää ohjelmointirajapinnan versiota 5.1.0 ja toteuttaa getFormattingModel uuden muotoilumallin apuohjelmien avulla osoitteessa GitHub – microsoft/PowerBI-visuals-sampleBarChart: Palkkikaavion mukautettu visualisointi opetusohjelmaa varten.

Aiheeseen liittyvä sisältö

Onko sinulla kysyttävää? Kysy Power BI -yhteisöltä -