Schopnosti a vlastnosti vizuálů Power BI

Každý vizuál má soubor capabilities.json , který se automaticky vytvoří při spuštění pbiviz new <visual project name> příkazu k vytvoření nového vizuálu. Soubor capabilities.json popisuje vizuál hostiteli.

Soubor capabilities.json sděluje hostiteli, jaký druh dat vizuál přijímá, jaké přizpůsobitelné atributy se mají umístit do podokna vlastností a další informace potřebné k vytvoření vizuálu. Počínaje rozhraním API verze 4.6.0 jsou všechny vlastnosti v modelu funkcí volitelné s výjimkou privileges, které jsou povinné.

Soubor capabilities.json obsahuje seznam kořenových objektů v následujícím formátu:

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

Když vytvoříte nový vizuál, výchozí soubor capabilities.json obsahuje následující kořenové objekty:

• Oprávnění
• role dat
• dataViewMappings
• Objekty

Výše uvedené objekty jsou ty, které jsou potřeba pro datové vazby. Je možné je upravit podle potřeby pro vizuál.

Následující další kořenové objekty jsou volitelné a je možné je přidat podle potřeby:

• Popisy
• supportsHighlight
• Řazení
• Procházení
• Expandcollapse
• supportsKeyboardFocus
• supportsSynchronizingFilterState
• advancedEditModeSupport
• supportsLandingPage
• supportsEmptyDataView
• supportsMultiVisualSelection
• Souhrny
• keepAllMetadataColumns
• Migrace

Všechny tyto objekty a jejich parametry najdete ve schématu capabilities.json.

oprávnění: Definujte speciální oprávnění, která vizuál vyžaduje.

Oprávnění jsou speciální operace, ke které vizuál vyžaduje přístup, aby mohl fungovat. Oprávnění přebírají pole privilege objektů, které definuje všechny vlastnosti oprávnění. Následující části popisují oprávnění, která jsou k dispozici v Power BI.

Poznámka

V rozhraní API verze 4.6.0 musí být oprávnění zadána v souboru capabilities.json . V dřívějších verzích je vzdálený přístup udělen automaticky a stahování souborů není možné. Pokud chcete zjistit, kterou verzi používáte, podívejte se do apiVersion souboru pbiviz.json .

Definování oprávnění

Definice oprávnění JSON obsahuje tyto komponenty:

• name - (řetězec) Název oprávnění.
• essential – (Logická hodnota) Označuje, jestli funkce vizuálu toto oprávnění vyžadují. Hodnota true znamená, že oprávnění je povinné; false znamená, že oprávnění není povinné.
• parameters – (pole řetězců)(volitelné) Argumenty. Pokud parameters chybí, považuje se za prázdné pole.

Je potřeba definovat dva typy oprávnění:

• Přístup k externím prostředkům
• Stáhnout do souboru

Poznámka

I s těmito oprávněními udělenými ve vizuálu musí správce povolit přepínač v nastavení správce, aby mohli uživatelé v organizaci tato nastavení využívat.

Povolit webový přístup

Pokud chcete vizuálu povolit přístup k externímu prostředku nebo webu, přidejte tyto informace jako oprávnění do oddílu schopností. Definice oprávnění obsahuje volitelný seznam adres URL, ke které má vizuál povolený přístup ve formátu http://xyz.com nebo https://xyz.com. Každá adresa URL může také obsahovat zástupný znak pro určení subdomén.

Příklad nastavení oprávnění umožňujícího přístup k externím prostředkům

{
    "name": "WebAccess",
    "essential": true,
    "parameters": [ "https://*.microsoft.com", "http://example.com" ]
}

Předchozí WebAccess oprávnění znamená, že vizuál musí přistupovat k jakékoli subdoméně microsoft.com domény pouze prostřednictvím protokolu HTTPS a example.com bez subdomén prostřednictvím protokolu HTTP a že toto přístupové oprávnění je nezbytné pro fungování vizuálu.

Stáhnout do souboru

Pokud chcete uživateli povolit export dat z vizuálu do souboru, nastavte ExportContent na true.

Toto ExportContent nastavení umožní vizuálu exportovat data do souborů v následujících formátech:

• .txt
• .csv
• .Json
• .tmplt
• .xml
• .pdf
• .xlsx

Toto nastavení je oddělené od a není ovlivněno omezeními stahování použitými v nastaveních tenanta organizace pro export a sdílení .

Příklad nastavení oprávnění umožňujícího stahování do souboru

"privileges": [
    {
        "name": "ExportContent",
        "essential": true
    }
]

Příklad definice oprávnění

"privileges": [
    {
        "name": "WebAccess",
        "essential": true,
        "parameters": [ "https://*.virtualearth.net" ]
    },
    {
        "name": "ExportContent",
        "essential": false
    }
]

Nepotřebujete žádná oprávnění.

Pokud vizuál nevyžaduje žádná zvláštní oprávnění, privileges pole by mělo být prázdné:

  "privileges": []

dataroles: definujte datová pole, která vizuál očekává.

K definování polí, které lze svázat s daty, použijte dataRoles. dataRoles je pole DataViewRole objektů, které definuje všechny požadované vlastnosti. Objekty dataRoles jsou pole , která se zobrazí v podokně Vlastnosti.

Uživatel do nich přetáhne datová pole a vytvoří vazbu mezi daty a objekty.

Vlastnosti role dat

Role dat jsou definovány následujícími vlastnostmi:

• name: Interní název tohoto datového pole (musí být jedinečný)
• displayName: Název, který se uživateli zobrazuje v podokně Vlastnosti
• kind: Druh pole:
  • Grouping: Sada diskrétních hodnot, které se používají k seskupení polí měr.
  • Measure: Jednoduché číselné hodnoty.
  • GroupingOrMeasure: Hodnoty, které lze použít jako seskupení nebo míru
• description: Krátký textový popis pole (volitelné).
• requiredTypes: Požadovaný typ dat pro tuto roli dat. Hodnoty, které se neshodují, jsou nastavené na null (nepovinné).
• preferredTypes: Preferovaný typ dat ro tuto roli dat (nepovinné)

Platné datové typy pro requiredTypes a preferredTypes

• bool: Logická hodnota
• integer: Celočíselná hodnota
• numeric: Číselná hodnota
• text: Textová hodnota
• geography: Geografická data

dataRoles – příklad

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

Předchozí role dat by vytvořily pole, která jsou zobrazená na následujícím obrázku:

dataViewMappings: způsob mapování dat

Objekty dataViewMappings popisují vzájemné vztahy datových rolí a umožňují určit podmíněné požadavky pro zobrazení dat.

Většina vizuálů poskytuje jedno mapování, můžete ale zadat více mapování DataViewMapping. Každé platné mapování vytvoří zobrazení dat.

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

Další informace najdete v článku Principy mapování zobrazení dat ve vizuálech Power BI.

objects: define property pane options

Objekty popisují přizpůsobitelné vlastnosti přidružené k vizuálu. Objekty definované v této části jsou objekty, které se zobrazují v podokně Formát. Každý objekt může mít více vlastností a každá vlastnost obsahuje typ, který je k ní přidružený.

"objects": {
    "myCustomObject": {
        "properties": { ... }
    }
}

Další informace najdete v článku Objekty a vlastnosti vizuálů Power BI.

Další kroky

• Principy mapování zobrazení dat ve vizuálech Power BI
• Objekty a vlastnosti vizuálů * Power BI Možnosti řazení pro vizuály Power BI