A Power BI-vizualizációk képességei és tulajdonságai
Minden vizualizáció rendelkezik egy capabilities.json fájllal, amelyet a parancs futtatásakor pbiviz new <visual project name>
automatikusan létrehoz egy új vizualizáció létrehozásához. A capabilities.json fájl leírja a vizualizációt a gazdagépnek.
A capabilities.json fájl tájékoztatja a gazdagépet arról, hogy milyen típusú adatokat fogad el a vizualizáció, milyen testreszabható attribútumokat kell elhelyezni a tulajdonságok panelen, valamint a vizualizáció létrehozásához szükséges egyéb információkat. Az API 4.6.0-s verziótól kezdve a képességmodell minden tulajdonsága opcionális, kivéve privileges
a szükséges tulajdonságokat.
A capabilities.json fájl a következő formátumban listázza a gyökérobjektumokat:
{
"privileges": [ ... ],
"dataRoles": [ ... ],
"dataViewMappings": [ ... ],
"objects": { ... },
"supportsHighlight": true|false,
"advancedEditModeSupport": 0|1|2,
"sorting": { ... }
...
}
Új vizualizáció létrehozásakor az alapértelmezett capabilities.json fájl a következő gyökérobjektumokat tartalmazza:
A fenti objektumok szükségesek az adatkötéshez. A vizualizációhoz szükséges módon szerkeszthetők.
A következő gyökérobjektumok nem kötelezőek, és szükség szerint hozzáadhatók:
- elemleírások
- supportsHighlight
- rendezés
- részletezés
- expandCollapse
- supportsKeyboardFocus
- supportsSynchronizingFilterState
- advancedEditModeSupport
- supportsLandingPage
- supportsEmptyDataView
- supportsMultiVisualSelection
- Részösszegek
- keepAllMetadataColumns
- migráció
Ezeket az objektumokat és azok paramétereit megtalálhatja a capabilities.json sémában
jogosultságok: határozza meg a vizualizációhoz szükséges speciális engedélyeket
A jogosultságok olyan speciális műveletek, amelyekhez a vizualizációnak hozzáférésre van szüksége a működéshez. A jogosultságok objektumtömböt privilege
vesznek fel, amely meghatározza az összes jogosultsági tulajdonságot. Az alábbi szakaszok a Power BI-ban elérhető jogosultságokat ismertetik.
Feljegyzés
Az API 4.6.0-s verzióban a jogosultságokat meg kell adni a capabilities.json fájlban. A korábbi verziókban a rendszer automatikusan engedélyezi a távelérést, és a fájlokba való letöltés nem lehetséges. Ha meg szeretné tudni, hogy melyik verziót használja, ellenőrizze a apiVersion
pbiviz.json fájlban.
Jogosultságok definiálása
A JSON-jogosultságdefiníció az alábbi összetevőket tartalmazza:
name
- (karakterlánc) A jogosultság neve.essential
- (logikai) Azt jelzi, hogy a vizualizáció működéséhez szükség van-e erre a jogosultságra. Az érték azttrue
jelenti, hogy a jogosultság szükséges;false
azt jelenti, hogy a jogosultság nem kötelező.parameters
- (karakterlánctömb)(nem kötelező) Argumentumok. Haparameters
hiányzik, akkor üres tömbnek számít.
A következő típusú jogosultságokat kell definiálni:
Feljegyzés
Még a vizualizációban megadott jogosultságok esetén is a rendszergazdának engedélyeznie kell a váltást a rendszergazdai beállításokban, hogy a szervezet tagjai kihasználhassák ezeket a beállításokat.
Webes hozzáférés engedélyezése
Ha engedélyezni szeretné egy vizualizáció számára, hogy hozzáférjen egy külső erőforráshoz vagy webhelyhez, adja hozzá ezt az információt jogosultságként a Képességek szakaszban. A jogosultságdefiníció tartalmazza azoknak az URL-címeknek az opcionális listáját, amelyekhez a vizualizáció hozzáférhet a formátumban http://xyz.com
vagy https://xyz.com
a formátumban. Minden URL-cím tartalmazhat helyettesítő karaktereket is az altartományok megadásához.
Az alábbi kód egy példa a külső erőforrásokhoz való hozzáférést lehetővé tevő jogosultságokra:
{
"name": "WebAccess",
"essential": true,
"parameters": [ "https://*.microsoft.com", "http://example.com" ]
}
Az előző WebAccess
jogosultság azt jelenti, hogy a vizualizációnak csak HTTPS protokollon keresztül kell example.com
hozzáférnie a microsoft.com
tartomány bármely altartományához, altartományok nélkül HTTP-en keresztül, és hogy ez a hozzáférési jogosultság elengedhetetlen a vizualizáció működéséhez.
Letöltés fájlba
Ha engedélyezni szeretné a felhasználónak, hogy adatokat exportáljon egy vizualizációból egy fájlba, állítsa be a következőt ExportContent
true
: .
Ez a ExportContent
beállítás lehetővé teszi, hogy a vizualizáció az alábbi formátumokban exportálja az adatokat a fájlokba:
- .txt
- .csv
- .json
- .tmplt
- .xml
- .xlsx
Ezt a beállítást nem érintik a szervezet exportálási és megosztási bérlői beállításaiban alkalmazott letöltési korlátozások.
Az alábbi kód egy példa egy olyan jogosultsági beállításra, amely lehetővé teszi a fájlba való letöltést:
"privileges": [
{
"name": "ExportContent",
"essential": true
}
]
Helyi tárolási jogosultságok
Ez a jogosultság lehetővé teszi, hogy egy egyéni vizualizáció információkat tároljon a felhasználó helyi böngészőjében.
Az alábbiakban egy olyan jogosultsági beállítást mutatunk be, amely lehetővé teszi a helyi tároló használatát:
"privileges": [
{
"name": "LocalStorage",
"essential": true
}
]
Nincs szükség jogosultságokra
Ha a vizualizáció nem igényel különleges engedélyeket, a privileges
tömbnek üresnek kell lennie:
"privileges": []
Több jogosultság
Az alábbi példa bemutatja, hogyan állíthat be több jogosultságot egy egyéni vizualizációhoz.
"privileges": [
{
"name": "WebAccess",
"essential": true,
"parameters": [ "https://*.virtualearth.net" ]
},
{
"name": "ExportContent",
"essential": false
}
]
dataroles: határozza meg a vizualizáció által várt adatmezőket
Az adatokhoz köthető mezők definiálásához használja dataRoles
a következőt: . dataRoles
egy objektumtömb DataViewRole
, amely meghatározza az összes szükséges tulajdonságot. Az dataRoles
objektumok a Tulajdonságok panelen megjelenő mezők.
A felhasználó adatmezőket húz be azokba, hogy az adatmezőket az objektumokhoz kösse.
DataRole-tulajdonságok
DataRoles definiálása a következő tulajdonságokkal:
- név: Az adatmező belső neve (egyedinek kell lennie).
- displayName: A felhasználó számára a Tulajdonságok panelen megjelenő név.
- típus: A mező típusa:
Grouping
: A mértékmezők csoportosításához használt különálló értékek halmaza.Measure
: Egyetlen numerikus érték.GroupingOrMeasure
: Csoportosításként vagy mértékként használható értékek.
- leírás: A mező rövid szöveges leírása (nem kötelező).
- requiredTypes: Az adatszerepkörhöz szükséges adattípus. A nem egyező értékek null értékre vannak állítva (nem kötelező).
- preferredTypes: Az adatszerepkör előnyben részesített adattípusa (nem kötelező).
Érvényes adattípusok a requiredTypes és a preferredTypes esetében
- bool: Logikai érték
- egész szám: Egész szám
- numerikus: Numerikus érték
- szöveg: Szöveges érték
- földrajzi hely: Földrajzi adatok
dataRoles-példa
"dataRoles": [
{
"displayName": "My Category Data",
"name": "myCategory",
"kind": "Grouping",
"requiredTypes": [
{
"text": true
},
{
"numeric": true
},
{
"integer": true
}
],
"preferredTypes": [
{
"text": true
}
]
},
{
"displayName": "My Measure Data",
"name": "myMeasure",
"kind": "Measure",
"requiredTypes": [
{
"integer": true
},
{
"numeric": true
}
],
"preferredTypes": [
{
"integer": true
}
]
}
]
...
}
Az előző adatszerepkörök a következő képen megjelenő mezőket hozzák létre:
dataViewMappings: hogyan szeretné leképezni az adatokat
Az dataViewMappings
objektumok azt írják le, hogy az adatszerepkörök hogyan kapcsolódnak egymáshoz, és lehetővé teszik a megjelenítendő adatnézetek feltételes követelményeinek megadását.
A legtöbb vizualizáció egyetlen leképezést biztosít, de több dataViewMappings funkciót is megadhat. Minden érvényes leképezés létrehoz egy adatnézetet.
"dataViewMappings": [
{
"conditions": [ ... ],
"categorical": { ... },
"table": { ... },
"single": { ... },
"matrix": { ... }
}
]
További információt a Power BI-vizualizációk adatnézet-leképezésének ismertetése című témakörben talál.
objektumok: tulajdonságpanel-beállítások megadása
Az objektumok a vizualizációhoz társított testreszabható tulajdonságokat írják le. Az ebben a szakaszban definiált objektumok a Formátum panelen megjelenő objektumok. Minden objektum több tulajdonsággal rendelkezhet, és mindegyik tulajdonsághoz tartozik egy típus.
"objects": {
"myCustomObject": {
"properties": { ... }
}
}
Az egyéni vizualizáció dinamikus formázási sztringjeinek támogatásához például adja meg a következő objektumot:
"objects": {
"general": {
"properties": {
"formatString": {
"type": {
"formatting": {
"formatString": true
}
}
}
}
},
További információ: Power BI-vizualizációk objektumai és tulajdonságai.