Možnosti a vlastnosti vizuálov služby Power BICapabilities and properties of Power BI visuals

Možnosti sa používajú na poskytovanie informácie o vizuáli hostiteľovi.You use capabilities to provide information to the host about your visual. Všetky vlastnosti v modeli možností sú optional.All properties on the capabilities model are optional.

Hlavné objekty možností vizuálu sú dataRoles, dataViewMappings atď.The root objects of a visual's capabilities are dataRoles, dataViewMappings, and so on.

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

Určenie údajových polí, ktoré váš vizuál očakáva: dataRolesDefine the data fields that your visual expects: dataRoles

Ak chcete definovať polia, ktoré môžu byť viazané na údaje, použijete dataRoles.To define fields that can be bound to data, you use dataRoles. dataRoles zaberie pole objektov DataViewRole, ktoré definuje všetky požadované vlastnosti.dataRoles takes an array of DataViewRole objects, which defines all the required properties.

VlastnostiProperties

  • name: Interný názov tohto údajového poľa (musí byť jedinečný).name: The internal name of this data field (must be unique).
  • kind: Druh poľa:kind: The kind of field:
    • Grouping: Diskrétne hodnoty, ktoré sa používajú na zoskupenie polí mierok.Grouping: Discrete values that are used to group measure fields.
    • Measure: Číselné hodnoty údajov.Measure: Numeric data values.
    • GroupingOrMeasure: Hodnoty, ktoré sa dajú použiť buď ako zoskupenie alebo mierka.GroupingOrMeasure: Values that can be used as either a grouping or a measure.
  • displayName: Názov zobrazený používateľovi na table Vlastnosti.displayName: The name displayed to the user in the Properties pane.
  • description: Krátky popis poľa (voliteľné).description: A short description of the field (optional).
  • requiredTypes: Požadovaný typ údajov pre túto rolu údajov.requiredTypes: The required type of data for this data role. Hodnoty, ktoré sa nezhodujú, sa nastavia na hodnotu null (voliteľné).Values that don't match are set to null (optional).
  • preferredTypes: Preferovaný typ údajov pre túto rolu údajov (voliteľné).preferredTypes: The preferred type of data for this data role (optional).

Platné typy údajov vo vlastnostiach requiredTypes a preferredTypesValid data types in requiredTypes and preferredTypes

  • bool: Boolovská hodnotabool: A boolean value
  • integer: Celočíselná hodnota (celé číslo)integer: An integer (whole number) value
  • numeric: Numerická hodnotanumeric: A numeric value
  • text: Textová hodnotatext: A text value
  • geography: Geografické údajegeography: A geographic data

PríkladExample

"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
            }
        ]
    },
    {
        "displayNameKey": "Visual_Location",
        "name": "Locations",
        "kind": "Measure",
        "displayName": "Locations",
        "requiredTypes": [
            {
                "geography": {
                    "address": true
                }
            },
            {
                "geography": {
                    "city": true
                }
            },
            {
                "geography": {
                    "continent": true
                }
            },
            {
                "geography": {
                    "country": true
                }
            },
            {
                "geography": {
                    "county": true
                }
            },
            {
                "geography": {
                    "place": true
                }
            },
            {
                "geography": {
                    "postalCode": true
                }
            },
            {
                "geography": {
                    "region": true
                }
            },
            {
                "geography": {
                    "stateOrProvince": true
                }
            }
        ]
    }
]

Predchádzajúce roly údajov by vytvorili polia, ktoré sú znázornené na nasledujúcom obrázku:The preceding data roles would create the fields that are displayed in the following image:

Polia roly údajov

Určenie, ako sa majú priraďovať údaje: dataViewMappingsDefine how you want the data mapped: dataViewMappings

Vlastnosť dataViewMappings popisuje, ako roly údajov navzájom súvisia, a umožňuje určiť pre ne podmienky podmienenosti.A DataViewMappings property describes how the data roles relate to each other and allows you to specify conditional requirements for the them.

Väčšina vizuálov poskytuje jednoduché priraďovanie, ale môžete použiť aj viacnásobné dataViewMappings.Most visuals provide a single mapping, but you can provide multiple dataViewMappings. Každé platné mapovanie vyprodukuje zobrazenie údajov.Each valid mapping produces a data view.

"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.For more information, see Understand data view mapping in Power BI visuals.

Určenie možností tably vlastností: objektyDefine property pane options: objects

Objekty popisujú prispôsobiteľné vlastnosti priradené k vizuálu.Objects describe customizable properties that are associated with the visual. Každý objekt môže mať viacero vlastností a ku každej vlastnosti je priradený typ.Each object can have multiple properties, and each property has a type that's associated with it. Typy odkazujú, o akú vlastnosť pôjde.Types refer to what the property will be.

"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.For more information, see Objects and properties of Power BI visuals.

Spracovať čiastočné zvýraznenie: supportsHighlightHandle partial highlighting: supportsHighlight

V predvolenom nastavení je táto hodnota nastavená na false, čo znamená, že vaše hodnoty sa automaticky filtrujú, keď sa na strane niečo vyberie.By default, this value is set to false, which means that your values are automatically filtered when something on the page is selected. Toto automatické filtrovanie v zápätí aktualizuje vizuál tak, aby sa zobrazila len vybratá hodnota.This automatic filtering in turn updates your visual to display only the selected value. Ak chcete zobraziť úplné údaje, ale zvýrazniť len vybraté položky, je potrebné nastaviť supportsHighlight na hodnotu true v súbore capabilities.json.If you want to display the full data but highlight only the selected items, you need to set supportsHighlight to true in your capabilities.json file.

Ďalšie informácie nájdete v téme Zvýraznenie údajových bodov vo vizuáloch služby Power BI.For more information, see Highlight data points in Power BI visuals.

Spracovať rozšírený režim úprav: advancedEditModeSupportHandle advanced edit mode: advancedEditModeSupport

Vizuál môže deklarovať podporu rozšíreného režimu úprav.A visual can declare its support of advanced edit mode. V predvolenom nastavení vizuál nepodporuje rozšírený režim úprav, pokiaľ to nie je uvedené inak v súbore capabilities json.By default, a visual doesn't support advanced edit mode, unless stated otherwise in the capabilities.json file.

Ďalšie informácie nájdete v téme Rozšírený režim úprav vo vizuáloch služby Power BI.For more information, see Advanced edit mode in Power BI visuals.

Možnosti zoradenia údajov pre vizuál: zoradenieData sorting options for visual: sorting

Vizuál môže definovať spôsob zoradenia prostredníctvom možností.A visual can define its sorting behavior via its capabilities. V predvolenom nastavení vizuál nepodporuje zmenu zoradenia, pokiaľ to nie je uvedené inak v súbore capabilities json.By default, a visual doesn't support modifying its sorting order, unless stated otherwise in the capabilities.json file.

Ďalšie informácie nájdete v téme Možnosti zoradenia pre vizuály služby Power BI.For more information, see Sorting options for Power BI visuals.