Vyžiadanie agregovaných medzisúčtových údajov

Rozhranie API súčtov a medzisúčtov umožňuje vlastným vizuálom so zobrazením maticových údajov požadovať agregované medzisúčty údajov od hostiteľa služby Power BI. Medzisúčty sa vypočítajú pre celý sémantický model matice alebo zadané pre jednotlivé úrovne hierarchie údajov matice. Príklad rozhrania API súčtov a medzisúčtov vo vizuáli služby Power BI nájdete v ukážkovej zostave.

Poznámka

Požadovanie medzisúčtov údajov je podporované vo verzii 2.6.0 a novšej. Vlastnosť rowSubtotalType je k dispozícii vo verzii 5.1.0 a novšej. Ak chcete zistiť, ktorú verziu používate, pozrite si apiVersionsúbor pbiviz.json .

Vždy, keď vizuál obnoví údaje, vizuál vydá požiadavku na načítanie údajov na koncový server služby Power BI. Tieto žiadosti o údaje sú zvyčajne pre hodnoty polí, ktoré používateľ presunul do zdrojov polí vizuálu. Vizuál niekedy potrebuje iné agregácie alebo medzisúčty (napríklad súčet alebo počet) použité v kontajneroch polí. Rozhranie API súčtov a medzisúčtov umožňuje prispôsobiť dotaz o odchádzajúcich údajoch tak, aby požadoval viac agregácie alebo medzisúčtu údajov.

Rozhranie API medzisúčtov

Rozhranie API ponúka nasledujúce prispôsobenie pre každý typ zobrazenia údajov (v súčasnosti iba v zobrazení maticových údajov).

• rowSubtotals: (booleovská hodnota) Udáva, či majú byť požadované údaje medzisúčtu pre všetky polia v kontajneri polí riadkov.
• rowSubtotalsPerLevel: (booleovská hodnota) Udáva, či je možné prepnúť údaje medzisúčtu pre jednotlivé polia v kontajneri poľa riadka.
• columnSubtotals: (booleovská hodnota) Udáva, či sa majú požiadať o údaje medzisúčtu pre všetky polia v kontajneri polí stĺpcov.
• columnSubtotalsPerLevel: (booleovská hodnota) Udáva, či je možné prepnúť údaje medzisúčtu pre jednotlivé polia v kontajneri polí stĺpcov.
• levelSubtotalEnabled: (booleovská hodnota) Udáva, či sú medzisúčty požadované pre riadok alebo stĺpec. Na rozdiel od všetkých ostatných vlastností sa táto vlastnosť použije na jednotlivé riadky alebo stĺpce.
• rowSubtotalsType: ("Top" alebo "Bottom") Udáva, či sa má riadok s celkovými údajmi načítať pred (top) alebo po (bottom) zvyšku údajov. Ak je táto vlastnosť nastavená na bottomhodnotu , súčet možno zobraziť až po načítaní všetkých údajov. Predvolená hodnota je bottom.

Každému z predtým uvedených prepínačov sa priradí hodnota na základe súvisiacich vlastností na table vlastností a predvolených hodnôt.

Ako používať rozhranie API medzisúčtu

Súbor capabilities.json vizuálu musí:

• Vlastnosť určite, do akej sa každý z vyššie uvedených prepínačov mapuje.
• zadajte predvolenú hodnotu, ktorá sa má použiť, ak vlastnosť nie je definovaná.

Prepínače používajú formát, ako je v nasledujúcom príklade:

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

Predchádzajúci kód označuje, že medzisúčty riadkov sú povolené vlastnosťou rowSubtotals v objekte subTotals . Vlastnosť má predvolenú hodnotu true.

Rozhranie API sa automaticky povolí pre vizuál vždy, keď je v súbore capabilities.json definovaná štruktúra medzisúčtov a všetky prepínače mapovania.

Nasledujúci kód je príkladom kompletnej konfigurácie rozhrania API v súbore capabilities.json (skopírovaný zo vzorového vizuálu rozhrania API):

"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"
            }
        } 
    }

Je dôležité, aby bola funkcia vizuálu enumerateProperties() zarovnaná s predvolenými hodnotami zadanými v súbore capabilities json . Logika prispôsobenia funguje v súlade so zadanými predvolenými hodnotami. enumerateProperties() Ak funkcia a predvolené hodnoty nie sú zarovnané, skutočné prispôsobenia medzisúčtu sa môžu líšiť od očakávaní používateľov.

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

Ak chcete skontrolovať dostupné prispôsobenia, rozbaľte rozbaľovaciu ponuku Medzisúčty na table vlastnosti Formát . Upravte nastavenia medzisúčtov a sledujte zmeny prezentácie medzisúčtov (s názvom Súčty) na table Vizualizácie.

Dôležité informácie a obmedzenia

• Vlastnosť rowSubtotalsType je k dispozícii len pre riadky. Medzisúčty stĺpcov nie je možné nastaviť na začiatok stĺpca.

• Funkcia rozbalenia a zbalenia prepíše rowSubtotals. Medzisúčty sa zobrazia po rozbalení riadkov, a to aj vtedy, ak rowSubtotals je nastavená na hodnotu false.

Súvisiaci obsah

Pridanie interaktivity do vizuálu pomocou výberov vizuálov služby Power BI