O painel Análise em visuais do Power BI

O painel Análise permite que você adicione linhas de referência dinâmicas como mín., máx. ou média aos seus visuais. Essas linhas podem ajudar você a ampliar tendências ou insights importantes. Este artigo discute como criar visuais do Power BI que podem apresentar e gerenciar linhas de referência dinâmicas no painel Análise.

Observação

O painel Análise está disponível na API versão 2.5.0. Para descobrir qual versão você está usando, confira o apiVersion no arquivo pbiviz.json.

Gerenciar o painel Análise

O gerenciamento de propriedades no painel Análise é semelhante ao gerenciamento de propriedades no painel Formatar. Você define um objeto no arquivo capabilities.json do visual.

Para o painel Análise, o objeto é definido da seguinte forma:

API 5.1+

Na definição do objeto, adicione apenas o nome do objeto, o nome da propriedade e o tipo, conforme explicado aqui. Exemplo:

{
  "objects": {
    "YourAnalyticsPropertiesCard": {
      "properties": {
        "show": {
          "type": {
            "bool": true
          }
        },
        "displayName": {
          "type": {
            "text": true
          }
        },
      ... //any other properties for your Analytics card
      }
    }
  ...
  }
}

APIs mais antigas (antes da versão 5.1)

1. Na definição do objeto, adicione o displayName e um campo objectCategory com um valor de 2.

   Observação

   O campo objectCategory define o aspecto do visual que o objeto controla (1=Formatação, 2=Análise). Use Formatting para elementos como aparência, cores, eixos e rótulos. Use Analytics para elementos como previsões, linhas de referência e formas.

   Se o valor objectCategory não for especificado, ele usará Formatting por padrão.

2. Adicione as seguintes duas propriedades ao objeto:

   • show do tipo bool, com um valor padrão de true
   • displayName do tipo text, com um valor padrão de true

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

No cartão de configurações de formatação, especifique que esse cartão pertence ao painel de análise definindo o parâmetro set card analyticsPane como true. Por padrão, o parâmetro analyticsPane é falso e o cartão será adicionado ao painel de formatação. Confira as seguintes implementações:

Usando utilitários FormattingModel

class YourAnalyticsCardSettings extends FormattingSettingsCard {
    show = new formattingSettings.ToggleSwitch({
        name: "show",
        displayName: undefined,
        value: false,
        topLevelToggle: true
    });

    displayNameProperty = new formattingSettings.TextInput({
        displayName: "displayName",
        name: "displayName",
        placeholder: "",
        value: "Analytics Instance",
    });

    name: string = "YourAnalyticsPropertiesCard";
    displayName: string = "Your analytics properties card's name";
    analyticsPane: boolean = true; // <===  Add and set analyticsPane variable to true 
    slices = [this.show, this.displayNameProperty];
}

Sem utilitários FormattingModel

      const show: powerbi.visuals.EnabledSlice = {
          uid: "enableAxisCard_topLevelToggle_show_uid",
          suppressDisplayName: true,
          control: {
              type: powerbi.visuals.FormattingComponent.ToggleSwitch,
              properties: {
                  descriptor: {
                      objectName: "YourAnalyticsPropertiesCard",
                      propertyName: "show"
                  },
                  value: false
              }
          }
      }
        
      const displayNameProperty: powerbi.visuals.FormattingSlice = {
          uid: "enableAxisCard_displayName_uid",
          suppressDisplayName: true,
          control: {
              type: powerbi.visuals.FormattingComponent.TextInput,
              properties: {
                  descriptor: {
                      objectName: "YourAnalyticsPropertiesCard",
                      propertyName: "displayName"
                  },
                  value: "Analytics Instance",
                  placeholder: ""
              }
          }
      }

      const averageLineCard: powerbi.visuals.FormattingCard = {
          displayName: "Your analytics properties card's name",
          uid: "yourAnalyticsCard_uid",
          analyticsPane: true, // <===  Add and set analyticsPane variable to true 
          topLevelToggle: show,
          groups: [{
              displayName: undefined,
              uid: "yourAnalyticsCard_group_uid",
              slices: [displayNameProperty],
          }]
      };

Defina outras propriedades da mesma maneira que você faz para objetos de Formato e enumere objetos da mesma forma que você faz no painel Formatar.

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).
• Todas as opções que controlam a aparência do visual (ou seja, a formatação), devem ser mantidas no painel Formatação.

Considerações e limitações

• O painel Análise ainda não tem suporte para várias instâncias. O único seletor que um objeto pode ter é estático (ou seja, selector: null), e visuais do Power BI não podem ter várias instâncias de um cartão definido pelo usuário.
• Propriedades do tipo integer não são exibidas corretamente. Como alternativa, use o tipo numeric em vez delas.

Próximas etapas

Adicionar formatação condicional