O painel Análise em visuais do Power BIThe Analytics pane in Power BI visuals

O painel Análise foi introduzido para visuais nativos em novembro de 2018.The Analytics pane was introduced for native visuals in November 2018. Este artigo discute como visuais do Power BI com a API v2.5.0 podem apresentar e gerenciar suas propriedades no painel Análise.This article discusses how Power BI visuals with API v2.5.0 can present and manage their properties in the Analytics pane.

O painel Análise

Gerenciar o painel AnáliseManage the Analytics pane

Assim como você gerenciaria as propriedades no painel Formato, você gerencia o painel Análise definindo um objeto no arquivo capabilities.json no visual.Just as you'd manage properties in the Format pane, you manage the Analytics pane by defining an object in the visual's capabilities.json file.

Para o painel Análise, as diferenças são as seguintes:For the Analytics pane, the differences are as follows:

  • Na definição do objeto, você adiciona um campo objectCategory com um valor de 2.Under the object's definition, you add an objectCategory field with a value of 2.

    Observação

    O campo objectCategory opcional foi introduzido na API 2.5.0.The optional objectCategory field was introduced in API 2.5.0. Ele define o aspecto do visual que o objeto controla (1 = Formatação, 2 = Análise).It defines the aspect of the visual that the object controls (1 = Formatting, 2 = Analytics). Formatting é usado para elementos como aparência, cores, eixos e rótulos.Formatting is used for such elements as look and feel, colors, axes, and labels. Analytics é usado para elementos como previsões, linhas de tendência, linhas de referência e formas.Analytics is used for such elements as forecasts, trendlines, reference lines, and shapes.

    Se o valor não for especificado, objectCategory usará "Formatting" como padrão.If the value isn't specified, objectCategory defaults to "Formatting."

  • O objeto precisa ter as duas propriedades a seguir:The object must have the following two properties:

    • show do tipo bool, com um valor padrão de false.show of type bool, with a default value of false.
    • displayName do tipo text.displayName of type text. O valor padrão que você escolhe se torna o nome de exibição inicial da instância.The default value that you choose becomes the instance's initial display name.
{
  "objects": {
    "YourAnalyticsPropertiesCard": {
      "displayName": "Your analytics properties card's name",
      "objectCategory": 2,
      "properties": {
        "show": {
          "type": {
            "bool": true
          }
        },
        "displayName": {
          "type": {
            "text": true
          }
        },
      ... //any other properties for your Analytics card
      }
    }
  ...
  }
}

Você pode definir outras propriedades da mesma maneira que faz para objetos de Formato.You can define other properties in the same way that you do for Format objects. E você pode enumerar objetos da mesma forma que no painel Formato.And you can enumerate objects just as you do in the Format pane.

Limitações e problemas conhecidos do painel AnáliseKnown limitations and issues of the Analytics pane

  • O painel Análise ainda não tem suporte para várias instâncias.The Analytics pane has no multi-instance support yet. Os objetos não podem ter um seletor que não seja estático (ou seja, "selector": null) e visuais do Power BI não podem ter várias instâncias de um cartão definidas pelo usuário.Objects can't have a selector other than static (that is, "selector": null), and Power BI visuals can't have user-defined multiple instances of a card.
  • Propriedades do tipo integer não são exibidas corretamente.Properties of type integer aren't displayed correctly. Como alternativa, use o tipo numeric em vez delas.As a workaround, use type numeric instead.

Observação

  • Use o painel Análise somente para objetos que adicionam novas informações ou esclarecem as informações apresentadas (por exemplo, linhas de referência dinâmica que ilustram tendências importantes).Use the Analytics pane only for objects that add new information or shed new light on the presented information (for example, dynamic reference lines that illustrate important trends).
  • Todas as opções que controlam a aparência do visual (ou seja, a formatação), devem ser mantidas no painel Formatação.Any options that control the look and feel of the visual (that is, formatting) should be limited to the Formatting pane.