O painel Análise nos visuais do Power BI

O painel Análise permite adicionar linhas de referência dinâmicas, como min, max ou average, aos seus elementos visuais. Essas linhas podem ajudá-lo a ampliar tendências ou insights importantes. Este artigo descreve como criar visuais do Power BI que podem apresentar e gerenciar linhas de referência dinâmicas no painel Análise .

Nota

O painel Analytics está disponível na API versão 2.5.0. Para descobrir qual versão você está usando, verifique o apiVersionno arquivo pbiviz.json .

Gerenciar o painel do Google Analytics

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

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

API 5.1+

Sob a 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 5.1)

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

   Nota

   O objectCategory campo define o aspeto 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 não for especificado, o objectCategory padrão será Formatting.

2. Adicione as duas propriedades a seguir 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 set card analyticsPane parâmetro como true. Por padrão, analyticsPane o parâmetro é false e o cartão será adicionado ao painel de formatação. Veja as seguintes implementações:

Usando FormattingModel Utils

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 FormattingModel Utils

      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 forma que faz para objetos Format e enumere objetos da mesma forma que faz no painel Formatar .

Nota

• Use o painel Análise apenas para objetos que adicionam novas informações ou lançam nova luz sobre as informações apresentadas (por exemplo, linhas de referência dinâmicas que ilustram tendências importantes).
• Quaisquer opções que controlem a aparência do visual (ou seja, formatação) devem ser limitadas ao painel Formatação .

Considerações e limitações

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

Conteúdos relacionados

Adicionar formatação condicional