Changelog da API de visuais do Power BI

  • Artigo

Esta página contém um breve resumo das versões de API existentes e o que esperar da próxima versão. As versões listadas aqui são consideradas estáveis e não mudam.

API v5.10.0

  • DataViewMetadataColumn tem uma nova propriedade chamada sourceFieldParameters. Esta propriedade indica se o campo atual é o resultado de um parâmetro field. Se um único campo pode se originar de vários parâmetros de campo, essa propriedade lista todos os parâmetros de campo relacionados.
  • Suporta Desktop junho de 2024

API v5.9.1

  • acquireAADTokenService: Melhorado para suportar as seguintes nuvens.
    • Nuvem comercial
    • China Cloud
    • Nuvem da comunidade do governo dos EUA
    • Nuvem da Comunidade do Governo dos EUA em alta
    • Nuvem do Departamento de Defesa dos EUA

API v5.9.0

  • API de filtro de identidade hierárquica: permite criar um visual que usa o mapeamento Matrix DataView para filtrar dados com base em pontos de dados que usam uma estrutura hierárquica. Isso é útil para visuais personalizados que aproveitam modelos semânticos de chaves agrupadas e desejam filtrar hierarquias com base em pontos de dados.
  • acquireAADTokenService: Estendido com propriedades adicionais
  • Suporta Desktop março 2024

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 global ativada por padrão. O administrador pode Desativar a configuração global para desativar a API herdada e a nova versão da API.
  • Suporte on-object para visuais personalizados: Suporte On object para visuais personalizados para otimizar a experiência do usuário e fornecer uma experiência de criação unificada a par com visuais prontos para uso.
  • Suporta Desktop fevereiro 2024

API v5.7.0

  • API de Autenticação de Visuais Personalizados do Power BI: Permite que Visuais Personalizados obtenham tokens de acesso do Microsoft Entra por meio de logon único (SSO), facilitando operações contextuais de usuário seguras e eficientes.
  • Controle dinâmico de perfuração: Permite que o visual habilite ou desabilite o recurso de perfuração dinamicamente usando uma chamada de API.
    • Quando o recurso de perfuração está ativado, todas as funcionalidades dos recursos de detalhamento e expandir/recolher estão disponíveis. Essas funcionalidades incluem chamadas de API, comandos de menu de contexto, botões de perfuração de cabeçalho e suporte para dados de hierarquia.
    • Quando o recurso de drill está desativado, essas funcionalidades não estão disponíveis.
  • Suporta Desktop dezembro 2023

API v5.4.0

  • Navegação melhorada pelo teclado: melhora a acessibilidade e a usabilidade dos seus elementos visuais, fornecendo mais opções para interagir com o visual utilizando o teclado.
  • Detetar o uso de filtros em relatórios: detete se há filtros aplicados a um relatório.
  • Suporta Desktop maio 2023

API v5.3.0

  • Correção de atualização do SelectionId para matriz dataView.

    Nota

    Os dados principais do selectionId podem mudar. Portanto, um selectionId/identityIndex persistente 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.
  • Suporta Desktop março 2023

API v5.2.0

  • Redução de dados personalizada - Este recurso adicionado a capabilities.json esquema permite que a janela de busca de dados seja modificada dinamicamente pelo código visual personalizado do autor do relatório.
  • Suporta Desktop dezembro 2022

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 resto dos dados
  • Filtro de identidade - filtrar dados categóricos
  • Novo painel de formato - crie um visual personalizado que suporte o novo design do painel de formato
  • Suporta Desktop outubro 2022

API v4.7.0

  • API de licenciamento - Vende, gerencie e aplique licenças diretamente através do mercado comercial.
  • API de detalhamento - Crie um visual que possa acionar uma operação de detalhamento por conta própria, sem interação do usuário.
  • Suporta Desktop julho 2022

API v4.6.0

  • Propriedade de novos recursos: privilégios e dois privilégios:
    • Acesso à Web
    • Baixar arquivo do visual personalizado
  • Adicionadas duas opções de administrador de locatário correspondentes
  • Baixar API para permitir o download visual para arquivo
  • Suporta Desktop junho 2022

API v4.2.0

API v3.8.0

  • Suporta Desktop May 2021 e posterior.

API v3.7.0

  • Suporta Desktop April 2021 e posterior.

API v3.6.0

API v3.4.0

  • fetchMoreData : new aggregateSegments parameter (default true), para suportar no-aggregation fetchMoreData
  • Suporta Desktop 2020 de novembro e posterior.
  • Suporta Desktop RS janeiro 2021 e posterior.

API v3.2.0

API v2.6.0

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

API v2.5.0

  • Suporta o Painel do Google Analytics
  • Suporta SelectionIdBuilder os métodos withMatrixNode e withTable
  • Não suporta DataRepetitionSelector mais interface, substituído por data.CustomVisualOpaqueIdentity interface

API v2.3.0

API v2.2.0

API v2.1.0

  • Melhorias de desempenho:
    • Tempos de carregamento mais rápidos
    • Menor espaço de memória
    • Dados otimizados e transações de eventos

Notas de versão

  • As APIs de filtragem refatorada estarão disponíveis na API 2.2 e não são suportadas na API 2.1.

  • Os elementos visuais receberão apenas o tipo dataView que foi declarado em seus recursos. Os elementos visuais que usaram vários tipos de dataView serão interrompidos como resultado desta atualização.

  • Não suporta DataViewScopeIdentity mais interface, substituído por data.DataRepetitionSelector interface. Se você usou a DataViewScopeIdentity propriedade key da interface, você pode substituí-la por JSON.stringify(identity)

  • undefined é substituído por null dentro do dataView. Ao iterar sobre uma matriz, usá-la var item in myArray ignora undefined, mas não ignora null. Os elementos visuais que usam esse padrão podem ser quebrados por esta atualização. Certifique-se de verificar null se há matrizes:

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

  • A proto propriedade não armazena mais metadados\dados ocultos dentro do dataView. Os elementos visuais que acessam propriedades via proto podem ser quebrados por esta 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

  • Suporta o novo tipo fillRule (gradiente) no esquema de recursos
  • Suporta a propriedade rule no esquema de recursos para propriedades de objeto

API v1.7.0

API v1.6.2

  • Suporta o modo de edição visual para entrar no modo de edição visual
  • Suporta visuais interativos (html) R do Power BI, com base em html

API v1.5.0

API v1.4.0

API v1.3.0

API v1.2.0

  • Adiciona colorPalette para gerenciar as cores usadas em seu visual.
  • Suporta seleção múltipla - selectionManager pode aceitar uma matriz de SelectionId.
  • Suporta visuais R usando scripts R

API v1.1.0

  • Suporta depuração visual no iFrame
  • Adiciona sandbox leve com inicialização mais rápida do iFrame
  • Corrige Capabilities.objects não suporta problema de tipo "texto"
  • Suporta pbiviz update a atualização de definições de tipo de API visual e esquema
  • Suporta --api-version flag in pbiviz new para criar visuais com uma versão específica da api
  • Suporta a versão alfa da API v1.2.0

Anfitrião Visual

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

API v1.0.0

  • Versão inicial da API