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

Rozhranie API Súčet a Medzisúčet umožňuje vlastným vizuálom s zobrazením údajov matice vyžiadať agregované údaje medzisúčta od hostiteľa služby Power BI. Medzisúčty možno vypočítať pre celú množinu údajov matice alebo špecifikovať pre jednotlivé úrovne hierarchie údajov matice (pozri túto vzorovú zostavu).

Poznámka

Požadovanie údajov medzisúčta je podporované z rozhrania API verzie 2.6.0. Ak chcete zistiť, akú verziu používate, spustite pbiviz -V príkaz .

Pri každom obnovení údajov sa pri obnovení vizuálu vyskytne požiadavka na načítanie údajov na server služby Power BI. Tieto žiadosti o údaje sú zvyčajne pre hodnoty polí, ktoré používateľ presunul do zdrojov polí vizuálu. Niekedy vizuál potrebuje iné agregácie/medzisúčty (napríklad súčet, počet) použité v týchto poliach. Rozhranie API prispôsobí dotaz odchádzajúcich údajov tak, aby vyžiadal dodatočné agregácie/medzisúčty. Keďže tieto výpočty vykonáva server služby Power BI, sú vysoko efektívne a použiteľné pre veľké množiny údajov.

Snímka obrazovky vizuálu so zvýrazneným riadkom a stĺpcami medzisúčtov.

Rozhranie API medzisúčtov

Rozhranie API ponúka nasledujúce booleovské prepínače prispôsobenia pre každý typ zobrazenia údajov (momentálne len matica):

  • rowSubtotals: označuje, či sa majú požadovať údaje medzisúčta pre všetky polia v zdroji poľa riadky
  • rowSubtotalsPerLevel: udáva, či je možné pre jednotlivé polia v zdroji poľa riadka prepnúť údaje medzisúčta.
  • columnSubtotals: udáva, či sa majú požadovať údaje medzisúčta pre všetky polia v zdroji poľa stĺpce
  • columnSubtotalsPerLevel: Udáva, či je možné pre jednotlivé polia v zdroji polí stĺpcov prepnúť údaje medzisúčta.
  • levelSubtotalEnabled: Na rozdiel od všetkých ostatných vlastností sa táto vlastnosť použije na jednotlivé riadky alebo stĺpce. Táto vlastnosť udáva, či sa pre riadok alebo stĺpec požadujú medzisúčty

Každý z vyššie uvedených prepínačov je priradený k hodnote na základe súvisiacich vlastností na table vlastností a predvolených hodnôt.

Používanie rozhrania API medzisúčta

Súbor JSON vizuálu má tieto možnosti:

  • špecifikovať vlastnosť, každý z vyššie uvedených prepínačov máp na
  • zadajte predvolenú hodnotu, ktorá sa má použiť, ak vlastnosť nie je definovaná

Prepínače vyzerajú takto:

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

Vyššie uvedené napríklad znamená, že medzisúčty riadkov sú povolené vlastnosťou rowSubtotals v objekte "medzisúčty". Má predvolenú hodnotu true.

Rozhranie API sa automaticky zapne pre vizuál vždy, keď sú v súbore JSON definované štruktúre medzisúčtov a všetky mapovania prepínačov.

Nižšie je príklad kompletnej konfigurácie rozhrania API v súbore 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 
            } 
        } 
    }

Je dôležité, aby funkcia enumerateProperities() vizuálu bola zarovnaná s predvolenými nastaveniami zadanými v možnostiach. Logika prispôsobenia bude zároveň fungovať podľa predvolených nastavení zadaných v možnostiach (pretože v zobrazení údajov nie sú zadané žiadne objekty). Tieto dva musia byť zarovnané. V opačnom prípade sa skutočné prispôsobenia medzisúčta môžu líšiť od vnímania používateľa.

Pozrite si túto vzorovú zostavu v priečinku DOC.

Ak chcete skontrolovať dostupné prispôsobenia, rozbaľte rozbaľovaciu ponuku Medzisúčty na table vlastností Formát, upravte nastavenia medzisúčtov a sledujte zmeny prezentácie medzisúčtov (s názvom Totals) vizuálom.

Rozbaľovacia ponuka medzisúčtov

Ďalšie kroky