Összesített részösszegadatok kérése

A Total and Subtotal API lehetővé teszi, hogy a mátrix adatnézettel rendelkező egyéni vizualizációk összesített részösszegadatokat kérjenek a Power BI-gazdagéptől. A részösszegeket a rendszer a mátrix szemantikai modelljére számítja ki, vagy a mátrixadat-hierarchia egyes szintjeihez van megadva. A Power BI-vizualizáció Total and Subtotal API-jának példájáért tekintse meg a mintajelentést.

Minden alkalommal, amikor egy vizualizáció frissíti az adatait, egy adatlehívási kérést küld a Power BI háttérrendszer felé. Ezek az adatkérelmek általában azon mezők értékeihez tartoznak, amelyeket a felhasználó a vizualizáció mezőkútjaiba húzott. Előfordulhat, hogy a vizualizációhoz más aggregációk vagy részösszegek (például összeg vagy darabszám) lehetnek alkalmazva a mezőkre. A Total and Subtotal API segítségével testre szabhatja a kimenő adat lekérdezést, hogy több összesítést vagy részösszeget kérjen.

A részösszegek API

Az API az alábbi testreszabást kínálja minden adatnézettípushoz (jelenleg csak mátrix adatnézetekhez).

• rowSubtotals: (logikai) Azt jelzi, hogy a részösszegadatokat az összes mezőhöz kell-e kérni a sorok mezőjében.
• rowSubtotalsPerLevel: (logikai) Azt jelzi, hogy a részösszegadatok a sor mezőinek egyes mezőihez kapcsolhatók-e.
• columnSubtotals: (logikai) Azt jelzi, hogy a részösszeg adatokat kell-e kérni az oszlopmező összes mezőjéhez.
• columnSubtotalsPerLevel: (logikai) Azt jelzi, hogy a részösszeg adatok az oszlopmező egyes mezőihez kapcsolhatók-e.
• levelSubtotalEnabled: (logikai) Azt jelzi, hogy a részösszegek a sorhoz vagy oszlophoz szükségesek-e. Az összes többi tulajdonságtól eltérően ez a tulajdonság az egyes sorokra vagy oszlopokra lesz alkalmazva.
• rowSubtotalsType: ("Top" vagy "Bottom") Azt jelzi, hogy a összes adatot tartalmazó sort a többi adat előtt (top) vagy utána (bottom) kell-e lekérni. Ha ez a tulajdonság bottomértékre van állítva, az összeg csak az összes adat beolvasása után jeleníthető meg. Az alapértelmezett érték a bottom.

Ezek a kapcsolók a tulajdonságpanel kapcsolódó tulajdonságai és az alapértelmezett értékek alapján kapnak értéket.

Hogyan használjuk a részösszeg API-t

A vizuális elem capabilities.json fájljának a következő feltételeket kell teljesítenie:

• adja meg azt a tulajdonságot, amelyet az egyes kapcsolók-hez rendelnek.
• adja meg a használni kívánt alapértelmezett értéket, ha a tulajdonság nincs meghatározva.

A kapcsolók a következő példához hasonló formátumot használnak:

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

Az előző kód azt jelzi, hogy a sor részösszegeit a subTotals objektumban rowSubtotals tulajdonság engedélyezi. A tulajdonság alapértelmezett értéke true.

Az API automatikusan engedélyezve van egy vizualizációhoz, amikor a részösszegek struktúrája és az összes kapcsolóleképezés a capabilities.json fájlban van definiálva.

Az alábbi kód egy példa a capabilities.json fájl teljes API-konfigurációjára (az API-mintavizualizációból másolva):

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

Fontos, hogy a vizualizáció enumerateProperties() függvénye igazodjon a capabilities.json fájlban megadott alapértelmezett értékekhez. A testreszabási logika a megadott alapértelmezett értékek szerint működik. Ha a enumerateProperties() függvény és az alapértelmezett értékek nincsenek igazítva, a tényleges részösszeg-testreszabások eltérhetnek a felhasználói elvárásoktól.

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

Az elérhető testreszabások áttekintéséhez bontsa ki a Részösszegek legördülő menüt a Formátum tulajdonságpanelen. Módosítsa a részösszegek beállításait, és kövesse nyomon a Részösszegek bemutató módosításait (neve Totals) a Vizualizációk panelen.

Szempontok és korlátozások

• A rowSubtotalsType tulajdonság csak sorokhoz érhető el. Az oszlop részösszegeit nem állíthatja be az oszlopok elejére.

• A kibontja és összecsukja funkció felülbírálja rowSubtotals. A részösszegek akkor is megjelennek, amikor a sorok ki vannak bontva, még akkor is, ha rowSubtotalshamis.

Kapcsolódó tartalom

Interaktivitás hozzáadása a vizualizációhoz Power BI-vizualizációk kijelöléseinek használatával