Možnosti a vlastnosti vizuálov služby Power BI

Každý vizuál má capabilities.jssúbor, ktorý popisuje vizuál hostiteľovi. Vlastnosť capabilities.jsna súbore hostiteľovi povie hostiteľovi, aký druh údajov vizuál prijíma, aké prispôsobiteľné atribúty sa majú umiestniť na tablu Vlastnosti a ďalšie informácie potrebné na vytvorenie vizuálu. Všetky vlastnosti v capabilities.jssúborevoliteľné.

Zoznam capabilities.jssúbore má nasledujúci formát:

{
    "dataRoles": [ ... ],
    "dataViewMappings": [ ... ],
    "objects":  { ... },
    "supportsHighlight": true|false,
    "advancedEditModeSupport": 0|1|2,
    "sorting": { ... }
    ...
}

Keď vytvoríte nový vizuál, predvolený vizuálcapabilities.jssúbor obsahuje nasledujúce hlavné objekty:

Vyššie uvedené objekty sú objekty, ktoré sú potrebné na väzbu údajov. Môžete ich podľa potreby upraviť pre váš vizuál.

Podľa potreby je možné pridať nasledujúce ďalšie koreňové objekty:

Všetky tieto objekty a ich parametre môžete nájsť v schémecapabilities.jsschéme.

dataroles : určenie údajových polí, ktoré váš vizuál očakáva

Ak chcete definovať polia, ktoré môžu byť viazané na údaje, použijete dataRoles. dataRoles je pole objektov DataViewRole , ktoré definuje všetky požadované vlastnosti. Objekty dataRolespolia, ktoré sa zobrazujú na table Vlastnosti.

Používateľ presunie do nich údajové polia, aby naviazal údaje údajových polí k objektom.

Vlastnosti v okne DataRole

Vlastnosti DataRoles sú definované nasledujúcimi vlastnosťami:

  • name: Interný názov tohto údajového poľa (musí byť jedinečný).
  • displayName: Názov zobrazený používateľovi na table Vlastnosti.
  • kind: Druh poľa:
    • Grouping: Diskrétne hodnoty, ktoré sa používajú na zoskupenie polí mierok.
    • Measure: Číselné hodnoty údajov.
    • GroupingOrMeasure: Hodnoty, ktoré sa dajú použiť buď ako zoskupenie alebo mierka.
  • description: krátky textový popis poľa (voliteľné).
  • requiredTypes: Požadovaný typ údajov pre túto rolu údajov. Hodnoty, ktoré sa nezhodujú, sa nastavia na hodnotu null (voliteľné).
  • preferredTypes: Preferovaný typ údajov pre túto rolu údajov (voliteľné).

Platné typy údajov pre requiredTypes a preferredTypes

  • bool: Boolovská hodnota
  • integer: celočíselná hodnota
  • numeric: Numerická hodnota
  • text: Textová hodnota
  • geography: Geografické údaje

príklad hodnoty dataRoles

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

Predchádzajúce roly údajov by vytvorili polia, ktoré sú znázornené na nasledujúcom obrázku:

Polia roly údajov

dataViewMappings: spôsob priradenia údajov

Objekty dataViewMappings popisujú, ako medzi sebe súvisia roly údajov, a umožňujú určiť podmienené požiadavky pre zobrazenie údajov.

Väčšina vizuálov poskytuje jednoduché priraďovanie, ale môžete použiť aj viacnásobné dataViewMappings. Každé platné mapovanie vyprodukuje zobrazenie údajov.

"dataViewMappings": [
    {
        "conditions": [ ... ],
        "categorical": { ... },
        "table": { ... },
        "single": { ... },
        "matrix": { ... }
    }
]

Ďalšie informácie nájdete v téme Vysvetlenie priradenia zobrazenia údajov vo vizuáloch služby Power BI.

objekty: definovanie možností tably vlastností

Objekty popisujú prispôsobiteľné vlastnosti priradené k vizuálu. Objekty definované v tejto sekcii sú objekty, ktoré sa zobrazujú na table Formát. Každý objekt môže mať viacero vlastností a ku každej vlastnosti je priradený typ.

"objects": {
    "myCustomObject": {
        "displayName": "My Object Name",
        "properties": { ... }
    }
}

Ďalšie informácie nájdete v téme Objekty a vlastnosti vizuálov služby Power BI.

Ďalšie kroky