Koostetun välisumman tietojen pyytäminen

Summan ja välisumman ohjelmointirajapinnan avulla mukautetut visualisoinnit, joissa on matriisin tietonäkymä, voivat pyytää koostettuja välisummatietoja Power BI -isännältä. Välisummat lasketaan koko matriisin semanttisesta mallista tai määritetään matriisin tietohierarkian yksittäisille tasoille. Malliraportissa on esimerkki Power BI -visualisoinnin summan ja välisumman ohjelmointirajapinnasta.

Muistiinpano

Välisummatietojen pyytämistä tuetaan versiossa 2.6.0 ja sitä uudemmissa versioissa. Ominaisuus rowSubtotalType on käytettävissä versiossa 5.1.0 ja sitä uudemmissa versioissa. Jos haluat tietää, mitä versiota käytät, tarkista apiVersion pbiviz.json-tiedostosta .

Aina, kun visualisointi päivittää tietonsa, visualisointi myöntää tietojen noutopyynnön Power BI -taustalähteeseen. Nämä tietopyynnöt koskevat yleensä niiden kenttien arvoja, jotka käyttäjä veti visualisoinnin kenttäsäilöihin. Joskus visualisointi tarvitsee muita koosteita tai välisummia (esimerkiksi summa tai määrä), joita käytetään kenttäsäilöissä. Summan ja välisumman ohjelmointirajapinnan avulla voit mukauttaa lähtevää tietokyselyä ja pyytää lisää kooste- tai välisummatietoja.

Välisummien ohjelmointirajapinta

-ohjelmointirajapinta tarjoaa seuraavat mukautukset kullekin tietonäkymätyypille (tällä hetkellä vain matriisin tietonäkymät).

• rowSubtotals: (totuusarvo) Ilmaisee, pyydetäänkö välisummatietoja kaikista Rivit-kentän kentistä.
• rowSubtotalsPerLevel: (totuusarvo) Ilmaisee, voidaanko välisumman tiedot ottaa käyttöön yksittäisissä kentissä rivin kentässä.
• columnSubtotals: (totuusarvo) Ilmaisee, pyydetäänkö välisummatietoja kaikista Sarakkeiden kentän kentistä.
• columnSubtotalsPerLevel: (totuusarvo) Ilmaisee, voidaanko välisummatiedot vaihtaa yksittäisissä kentissä Sarake-kentässä.
• levelSubtotalEnabled: (totuusarvo) Ilmaisee, pyydetäänkö riville tai sarakkeelle välisummia. Toisin kuin kaikki muut ominaisuudet, tätä ominaisuutta käytetään yksittäisissä riveissä tai sarakkeissa.
• rowSubtotalsType: ("Ylin" tai "Alhaalla") Ilmaisee, tuleeko kokonaistietoja sisältävä rivi noutaa ennen (top) tai jälkeen (bottom) muita tietoja. Jos tämän ominaisuuden bottomarvo on , kokonaismäärä voidaan näyttää vain, kun kaikki tiedot on noudettu. Oletusarvo on bottom.

Kullekin aiemmin listatulle kytkimelle määritetään arvo ominaisuusruudun liittyvien ominaisuuksien ja oletusarvojen perusteella.

Välisumman ohjelmointirajapinnan käyttäminen

Visualisoinnin capabilities.json-tiedoston on

• määrittää ominaisuuden, johon kukin yllä olevista vaihtaa.
• anna oletusarvo, jota käytetään, jos ominaisuutta ei ole määritetty.

Valitsimet käyttävät seuraavan esimerkin kaltaista muotoa:

    "rowSubtotals": { 
                "propertyIdentifier": { 
                    "objectName": "subTotals", 
                    "propertyName": "rowSubtotals" 
                }, 
                "defaultValue": true 
            },

Edellä oleva koodi ilmaisee, että -objektin -ominaisuus rowSubtotals ottaa rivin subTotals välisummat käyttöön. -ominaisuuden oletusarvo trueon .

Ohjelmointirajapinta otetaan automaattisesti käyttöön visualisoinnille aina, kun välisummien rakenne ja kaikkien valitsimien yhdistämismääritykset on määritetty capabilities.json-tiedostossa.

Seuraava koodi on esimerkki täydellisistä ohjelmointirajapintamäärityksistä capabilities.json-tiedostossa (kopioitu ohjelmointirajapinnan mallivisualisoinnista):

"subtotals": { 
        "matrix": { 
            "rowSubtotals": { 
                "propertyIdentifier": { 
                    "objectName": "subTotals", 
                    "propertyName": "rowSubtotals" 
                }, 
                "defaultValue": true 
            }, 
            "rowSubtotalsPerLevel": { 
                "propertyIdentifier": { 
                    "objectName": "subTotals", 
                    "propertyName": "perRowLevel" 
                }, 
                "defaultValue": false 
            }, 
            "columnSubtotals": { 
                "propertyIdentifier": { 
                    "objectName": "subTotals", 
                    "propertyName": "columnSubtotals" 
                }, 
                "defaultValue": true 
            }, 
            "columnSubtotalsPerLevel": { 
                "propertyIdentifier": { 
                    "objectName": "subTotals", 
                    "propertyName": "perColumnLevel" 
                }, 
                "defaultValue": false 
            }, 
            "levelSubtotalEnabled": { 
                "propertyIdentifier": { 
                    "objectName": "subTotals", 
                    "propertyName": "levelSubtotalEnabled" 
                }, 
                "defaultValue": true 
            },
            "rowSubtotalsType": {
                "propertyIdentifier": {
                    "objectName": "subtotals",
                    "propertyName": "rowSubtotalsType"
                },
                "defaultValue": "Bottom"
            }
        } 
    }

On tärkeää, että enumerateProperties() visualisoinnin funktio on tasassa capabilities.json-tiedostossa määritettyjen oletusarvojen kanssa. Mukautuslogiikka toimii määritettyjen oletusarvojen mukaisesti. Jos funktiota enumerateProperties() ja oletusarvoja ei ole tasattu, todelliset välisummien mukautukset saattavat erota käyttäjien odotuksista.

enum RowSubtotalType {
        Top = "Top",
        Bottom = "Bottom",
   }

Jos haluat tarkastella käytettävissä olevia mukautuksia, laajenna Välisummat-valikko Muotoile-ominaisuusruudussa. Muokkaa välisumma-asetuksia ja seuraa Välisummat-esityksen (nimeltä Summat) muutoksia Visualisoinnit-ruudussa.

Huomioitavat asiat ja rajoitukset

• - rowSubtotalsType ominaisuus on käytettävissä vain riveille. Et voi määrittää sarakkeiden välisummia sarakkeen alkuun.

• Laajenna - ja kutista-ominaisuus rowSubtotalsohittaa . Välisummat näytetään, kun rivit laajennetaan, vaikka rowSubtotals arvona olisi epätosi.

Liittyvä sisältö

Vuorovaikutteisuuden lisääminen visualisointiin Power BI:n visualisointien valintojen avulla