Log de mudanças de API de visuais do Power BI

  • Artigo

Essa página contém um resumo rápido das versões de API existentes e do que esperar na próxima versão. As versões listadas aqui são consideradas estáveis e não serão alteradas.

Em breve

  • Filtro de identidade hierárquica
  • Extensões da API de autenticação

API v5.8.0

  • API de armazenamento local: uma nova versão da API de armazenamento local disponível para todos os visuais personalizados e controlada por uma configuração de administrador global que estará ativada por padrão. O administrador pode desativar a configuração global para desabilitar a API herdada e a nova versão da API.
  • Suporte em objeto para visuais personalizados: suporte em objetos para visuais personalizados a fim de otimizar a experiência do usuário e fornecer uma experiência de criação unificada, comparável aos visuais prontos para uso.
  • Compatível com Desktop, fevereiro de 2024

API v5.7.0

  • API de Autenticação de Visuais Personalizados do Power BI: permite que os Visuais Personalizados obtenham tokens de acesso do Microsoft Entra pelo logon único (SSO), facilitando operações contextuais seguras e eficientes do usuário.
  • Controle dinâmico de detalhamento: permite que o visual habilite ou desabilite o recurso de detalhamento de forma dinâmica usando uma chamada à API.
    • Quando o recurso de detalhamento estiver habilitado, todas as funcionalidades dos recursos de drilldown e expansão/recolhimento estarão disponíveis. Essas funcionalidades incluem chamadas à API, comandos do menu de contexto, botões de detalhamento de cabeçalho e suporte para dados de hierarquia.
    • Quando o recurso de detalhamento está desabilitado, essas funcionalidades não ficam disponíveis.
  • Dá suporte ao Desktop em dezembro de 2023

API v5.4.0

API v5.3.0

  • Correção de atualização de SelectionId para matrizdataView.

    Observação

    Os dados principais do selectionId podem ser alterados. Portanto, um selectionId/identityIndex persistido usando uma versão mais antiga da API pode não ser relevante em visuais de matriz.

  • downloadService: adiciona um novo método exportVisualsContentExtended que retorna informações de resultado expandidas do download.
  • Dá suporte à Área de Trabalho em março de 2023

API v5.2.0

API v5.1.0

  • Classificação personalizada – classificação personalizada aprimorada para tabelas
  • Subtotais – novo Tipo de Subtotais indica se os totais devem ser recuperados antes ou depois do restante dos dados
  • Filtro de identidade – filtrar dados categóricos
  • Novo painel de formato – criar um visual personalizado que dê suporte ao novo design do painel de formato
  • Dá suporte ao Power BI Desktop de outubro de 2022

API v4.7.0

  • API de Licenciamento – venda, gerencie e imponha licenças diretamente por meio do marketplace comercial.
  • API de drilldown – crie um visual que possa disparar uma operação de drilldown por conta própria, sem interação do usuário.
  • Dá suporte à Área de Trabalho em julho de 2022

API v4.6.0

API v4.2.0

API v3.8.0

  • Dá suporte à Área de Trabalho de maio de 2021 e posterior.

API v3.7.0

  • Dá suporte à Área de Trabalho de abril de 2021 e posterior.

API v3.6.0

  • O visual pode receber atualizações do Power BI sem a necessidade de associar dados.
  • Dá suporte ao Desktop 2021 de fevereiro e posterior.
  • Dá suporte ao Desktop RS de maio de 2021 e posterior.

API v3.4.0

  • fetchMoreData: novo parâmetro aggregateSegments (o padrão é true) para dar suporte a fetchMoreData sem agregação
  • Dá suporte ao Desktop de novembro de 2020 e posterior.
  • Dá suporte ao Desktop RS de janeiro de 2021 e posterior.

API v3.2.0

  • Compatível com supportsMultiVisualSelection
  • Dá suporte ao Desktop de setembro de 2019 e posterior.
  • Dá suporte ao Desktop RS de janeiro de 2020 e posterior.

API v2.6.0

  • Adiciona isInFocus para atualizar a opção e o método switchFocusModeState para o host do visual
  • Dá suporte à personalização subtotais
  • Dá suporte ao Desktop 2019 de junho e posterior.
  • Dá suporte ao Desktop RS de maio de 2019 e posterior.

API v2.5.0

  • Dá suporte ao painel Análise
  • Dá suporte aos métodos SelectionIdBuilderwithMatrixNode e withTable
  • Não dá mais suporte à interface DataRepetitionSelector, substituída pela interface data.CustomVisualOpaqueIdentity

API v2.3.0

API v2.2.0

API v2.1.0

  • Aprimoramentos de desempenho:
    • Tempos de carregamento mais rápidos
    • Menor volume de memória
    • Transações de dados e eventos otimizadas

Notas de versão

  • As APIs de filtragem refatorada estarão disponíveis na API 2.2 e não têm suporte na API 2.1.

  • Os visuais receberão apenas o tipo dataView, declarado em seus recursos. Os visuais que usaram vários tipos dataView serão interrompidos em consequência dessa atualização.

  • Não dá mais suporte à interface DataViewScopeIdentity, substituída pela interface data.DataRepetitionSelector. Se você usou a propriedade de chave da interface DataViewScopeIdentity, pode substituí-la por JSON.stringify(identity)

  • undefined é substituído por null dentro do dataView. Na iteração em uma matriz usando var item in myArray, ela ignora undefined, mas não ignora null. Os visuais que usam esse padrão podem ser interrompidos por essa atualização. Certifique-se de verificar null nas matrizes:

    for (var item in myArray) {
   if (!item) {
     continue;
   }
   console.log(item);
}

  • A propriedade proto não armazena mais metadados\dados ocultos dentro do dataView. Os visuais que acessam as propriedades via proto podem ser interrompidos por essa atualização.

API v1.13.0

API v1.12.0

API v1.11.0

API v1.10.0

  • Adiciona ILocalizationManager
  • API de autenticação

API v1.9.0

API v1.8.0

  • Dá suporte ao novo tipo fillRule (gradiente) no esquema de funcionalidades
  • Dá suporte à propriedade regra no esquema de funcionalidades para propriedades de objeto

API v1.7.0

API v1.6.2

API v1.5.0

API v1.4.0

API v1.3.0

API v1.2.0

  • Adiciona colorPalette para gerenciar as cores usadas no visual.
  • Dá suporte a Seleção múltipla – selectionManager pode aceitar uma matriz de SelectionId.
  • Dá suporte a Visuais do R usando scripts do R

API v1.1.0

  • Dá suporte ao visual de depuração em iFrame
  • Adiciona uma área restrita de peso leve com inicialização mais rápida do iFrame
  • Corrige o problema Capabilities.objects não dá suporte ao tipo "texto"
  • Dá suporte a pbiviz update para atualizar definições e esquema de tipo de API de visuais
  • Dá suporte ao sinalizador --api-version em pbiviz new para criar visuais com uma versão de API específica
  • Dá suporte à versão alfa da API v 1.2.0

Host do visual

  • Adiciona createSelectionIdBuilder para criar identificadores exclusivos usados para a seleção de dados
  • Adiciona createSelectionManager para gerenciar o estado de seleção do Visual e comunica as alterações ao host do visual
  • Adiciona uma matriz de cores padrão para usar nos visuais

API v1.0.0

  • Versão da API inicial