Koostetun välisumman tietojen pyytäminen

Total- ja Subtotal API - mahdollistaa matriisitietonäkymässä olevien mukautettujen visualisointien pyytää koostettuja välisummatietoja Power BI -isännästä. Välisummat lasketaan koko matriisin semanttisesta mallista tai määritetään matriisin tietohierarkian yksittäisille tasoille. Katso esimerkkiraportin esimerkki Power BI -visualisoinnin summan ja välisumman ohjelmointirajapinnasta.

Muistiinpano

Välisummatietojen pyytämistä tuetaan versiossa 2.6.0 ja sitä uudemmissa versioissa. rowSubtotalType-ominaisuus on käytettävissä versiossa 5.1.0 ja sitä uudemmissa versioissa. Voit selvittää käyttämäsi version pbiviz.json tiedoston apiVersion.

Aina, kun visualisointi päivittää tietonsa, visualisointi myöntää tietojen noutamisen pyynnön Power BI -taustasovellukseen. 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älisummatietoja käyttää yksittäisissä kentissä rivin kentässä.
• columnSubtotals: (totuusarvo) Ilmaisee, tuleeko välisumma- tietoja pyytää kaikista Sarake-kentän kentistä.
• columnSubtotalsPerLevel: (totuusarvo) Ilmaisee, voidaanko välisumman voidaan ottaa käyttöön yksittäisissä kentissä Sarakkeet-kentässä.
• levelSubtotalEnabled: (totuusarvo) ilmaisee, pyydetäänkö välisummia riville tai sarakkeelle. Toisin kuin kaikki muut ominaisuudet, tätä ominaisuutta käytetään yksittäisissä riveissä tai sarakkeissa.
• rowSubtotalsType: ("Ylimmät" tai "Alimmat") Ilmaisee, tuleeko tiedot noudetaan ennen (top) tai jälkeen (bottom) muita tietoja. Jos tämän ominaisuuden arvoksi on määritetty bottom, kokonaismäärä voidaan näyttää vain, kun kaikki tiedot on noudettu. Oletusarvo on bottom.

Jokaiselle näistä valitsimista 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 vaihtaa yhdistää.
• 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ä rivien välisummat on otettu käyttöön ominaisuudella rowSubtotalssubTotals-objektissa. -ominaisuuden oletusarvo on true.

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 capabilities.json tiedoston täydellisestä ohjelmointirajapintamäärityksestä (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ä visualisoinnin enumerateProperties()-funktio on tasassa capabilities.json-tiedostossa määritettyjen oletusarvojen kanssa. Mukautuslogiikka toimii määritettyjen oletusarvojen mukaisesti. Jos enumerateProperties()-funktiota ja oletusarvoja ei ole tasattu, todelliset välisumman mukautukset saattavat erota käyttäjien odotuksista.

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

Jos haluat tarkastella käytettävissä olevia mukautuksia, laajenna Välisummat- avattavaa valikkoa Muotoile -ominaisuusruudun . 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.

• Laajentaa ja kutistaa -ominaisuus ohittaa rowSubtotals. Välisummat näytetään, kun rivit laajennetaan, vaikka rowSubtotals on määritetty false-.

Aiheeseen liittyvä sisältö

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