Changelog da API de visuais do Power BI
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 ativadapor 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étodoexportVisualsContentExtended
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 ajanela 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
- Novos sinalizadores para expandir e recolher cabeçalhos de linha
- Suporta Desktop fevereiro 2022
API v3.8.0
- Suporta Desktop May 2021 e posterior.
API v3.7.0
- Suporta Desktop April 2021 e posterior.
API v3.6.0
- O Visual pode receber atualizações do Power BI sem a necessidade de vincular dados.
- Suporta Desktop 2021 fevereiro e posterior.
- Suporta Desktop RS May 2021 e posterior.
API v3.4.0
-
fetchMoreData
: newaggregateSegments
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
- Suporta suportesMultiVisualSelection
- Suporta Desktop 2019 setembro e posterior.
- Suporta Desktop RS janeiro de 2020 e posterior.
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 pordata.CustomVisualOpaqueIdentity
interface
API v2.3.0
- API da página de destino
- API de armazenamento local
- API de filtro de tupla (filtro de várias colunas)
- API de eventos de renderização
API v2.2.0
- Suporta a restauração do Filtro JSON a partir do DataView
- ContextMenu API
- Suporta o recurso Drillthrough
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 pordata.DataRepetitionSelector
interface. Se você usou aDataViewScopeIdentity
propriedade key da interface, você pode substituí-la porJSON.stringify(identity)
undefined
é substituído pornull
dentro do dataView. Ao iterar sobre uma matriz, usá-lavar item in myArray
ignoraundefined
, mas não ignoranull
. Os elementos visuais que usam esse padrão podem ser quebrados por esta atualização. Certifique-se de verificarnull
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 viaproto
podem ser quebrados por esta atualização.
API v1.13.0
- Suporta segmentações de dados de sincronização, observe que isso só funciona para segmentações de dados de campo único devido ao estado atual do código PBI, leia mais.
- Acessibilidade: Suporte de alto contraste
- Acessibilidade: Sinalizador Permitir foco do teclado
API v1.12.0
- Temas de suporte
- Suporta fetchMoreData, observe que a API Fetch More Data ultrapassa o limite rígido de 30K pontos de dados
- API de dicas de ferramentas do Canvas
API v1.11.0
- FilterManager API
- Suporta Favoritos
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
- Suporta RESJSON
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
- Suporta Permitir interações para interatividade visual
API v1.4.0
- Suporta Localização
API v1.3.0
- Suporta dicas de ferramentas
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
sinalizador nopbiviz new
para criar elementos 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