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

API pre celkový a medzisúčet umožňuje vlastným vizuálom so zobrazením maticových údajov žiadať od hostiteľa služby Power BI agregované medzisúčty. 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 zostavy.

Nota

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 apiVersion v súbore 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 sa majú 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 polí riadka.
• columnSubtotals: (booleovská hodnota) Udáva, či sa majú požiadať medzisúčtu údaje pre všetky polia v kontajneri polí stĺpcov.
• : (booleovská hodnota) Udáva, či je možné pre jednotlivé polia v kontajneri polí stĺpcov prepnúť medzisúčtu.
• 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 riadok so celkovým údaje majú načítať pred (top) alebo po (bottom). Ak je táto vlastnosť nastavená na bottom, celkový súčet možno zobraziť až po načítaní všetkých údajov. Predvolená hodnota je bottom.

Každému z týchto 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í:

• zadajte vlastnosť, do ktorou prepnutie mapovanie.
• 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 úplnej konfigurácie rozhrania API v súbore capabilities.json (skopírovaný z ukážkové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 sa funkcia enumerateProperties() vizuálu zarovnala s predvolenými hodnotami uvedenými v súbore capabilities.json. Logika prispôsobenia funguje v súlade so zadanými predvolenými hodnotami. Ak funkcia enumerateProperties() 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 si chcete skontrolovať dostupné prispôsobenia, rozbaľte rozbaľovaciu ponuku Medzisúčty na table vlastností Format . 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 rozbaliť a zbaliť prepíše rowSubtotals. Medzisúčty sa zobrazia po rozbalení riadkov, a to aj v prípade, že rowSubtotals je false.

Súvisiaci obsah

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