Megosztás a következőn keresztül:

A Power BI-vizualizációk képességei és tulajdonságai

  • Cikk

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 privilegesa 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:

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 azt true 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. Ha parameters 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.coma 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
  • .pdf
  • .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 dataRolesa 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:

Adatszerepkör-mezők

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.

Kapcsolódó tartalom