O POWER BI É PARA VOCÊ

Cada visual tem um arquivo capabilities.json que descreve o visual para o host. O arquivo capabilities.json informa ao host que tipo de dados o visual aceita, quais atributos personalizáveis colocar no painel de propriedades e outras informações necessárias para criar o visual. Todas as propriedades no arquivo capabilities.json são opcionais.

O arquivo capabilities.json tem o seguinte formato:

JSONCopiar

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

Quando você cria um visual, o arquivo capabilities.json padrão inclui os seguintes objetos raiz:

• dataRoles
• dataViewMappings
• objects

Os objetos acima são aqueles necessários para a associação de dados. Eles podem ser editados conforme necessário para o seu visual.

Os seguintes objetos raiz adicionais podem ser adicionados conforme necessário:

• tooltips
• supportsHighlight
• classificação
• busca detalhada
• suppressDefaultTitle
• supportsKeyboardFocus
• supportsSynchronizingFilterState
• advancedEditModeSupport
• supportsLandingPage
• supportsEmptyDataView
• supportsMultiVisualSelection
• subtotais

Você pode encontrar todos esses objetos e os respectivos parâmetros no esquema nocapabilities.json

dataroles: definir os campos de dados esperados pelo visual

Para definir os campos que podem ser associados aos dados, use dataRoles. dataRoles é uma matriz de objetos DataViewRole, que define todas as propriedades necessárias. Os objetos dataRoles são os campos que aparecem no painel Propriedades.

O usuário arrasta os campos de dados até eles para associar os campos de dados aos objetos.

Propriedades de dataRole

Os dataRoles são definidos pelas seguintes propriedades:

• name: o nome interno deste campo de dados (deve ser exclusivo).
• displayName: o nome exibido para o usuário no painel Propriedades.
• kind: o tipo de campo:
  • Grouping: valores discretos usados para agrupar campos de medida.
  • Measure: valores de dados numéricos.
  • GroupingOrMeasure: valores que podem ser usados como um agrupamento ou uma medida.
• description: um breve texto de descrição do campo (opcional).
• requiredTypes: o tipo de dados necessário para essa função de dados. Os valores que não correspondem são definidos como null (opcional).
• preferredTypes: o tipo de dados preferencial para essa função de dados (opcional).

Tipos de dados válidos para requiredTypes e preferredTypes

• bool: um valor booliano
• integer: um valor inteiro
• numeric: um valor numérico
• text: Um valor de texto
• geography: um dado geográfico

Exemplo de dataRoles

JSONCopiar

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

As funções de dados anteriores criariam os campos exibidos na imagem a seguir:

dataViewMappings: como você deseja mapear os dados

Os objetos dataViewMappings descrevem como as funções de dados se relacionam entre si e permitem que você especifique requisitos condicionais para as exibições de dados.

A maioria dos visuais fornece um mapeamento único, mas você pode fornecer vários DataViewMappings. Cada mapeamento válido produz uma exibição de dados.

JSONCopiar

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

Para obter mais informações, confira Entender o mapeamento de exibição de dados em visuais do Power BI.

objects: definir opções do painel de propriedade

Objetos descrevem propriedades personalizáveis associadas ao visual. Os objetos definidos nesta seção são os objetos que aparecem no painel Formatar. Cada objeto pode ter várias propriedades e cada propriedade tem um tipo associado a ela.

JSONCopiar

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

Para obter mais informações, confira Objetos e propriedades de visuais do Power BI.

Fonte.