Componente Power BI
O bloco Power BI foi pensado para incorporar relatórios e dashboards interativos na página com controlo sobre autenticação, navegação interna, filtros, bookmarks, landing page e comportamento do iframe em desktop e mobile. É uma solução orientada para cenários em que o dado precisa de entrar no frontend com contexto visual e flexibilidade de configuração.
Informações gerais
O bloco Power BI permite embutir relatórios do ecossistema Microsoft Power BI diretamente no Studio CMS, preservando a lógica de consulta, navegação e apresentação do próprio relatório. É especialmente útil para painéis executivos, dashboards operacionais, reporting comercial, visualização analítica e contextos em que a atualização do dado já vive na origem do Power BI.
Este bloco pode incluir:
- Full URL e Full URL (mobile) para controlar embeds distintos por dispositivo
- Report ID, Group ID e Client ID para identificar o relatório, o workspace e o tenant
- Auto Auth para automatizar a autenticação do utilizador quando o projeto o suporta
- Nav Content Panel Enabled e Filter Pane Enabled para mostrar ou esconder a navegação e os filtros do relatório
- Page Name, Report Section, Bookmark e Filter para definir a página de entrada e a leitura inicial do embed
- Page View, Fullscreen, Autoplay, Chromeless e Action Bar Enabled para ajustar o modo de visualização e a experiência do utilizador
- Config para configurações técnicas adicionais do embed
- controlo de Iframe Height e Iframe Width em versões separadas para desktop e mobile
Utiliza este componente quando a página precisa de mostrar dados vivos, relatórios detalhados ou dashboards interativos sem reconstruir a visualização no frontend. O ganho está na ligação direta ao relatório, mas isso pede atenção redobrada a performance, legibilidade, autenticação e adaptação entre ecrãs.
Exemplos visuais do bloco
3 leituras típicas de embed analítico
O bloco Power BI pode ser usado de formas diferentes consoante a profundidade analítica necessária, a quantidade de navegação visível e a adaptação entre desktop e mobile. Os três exemplos abaixo são simulações visuais que representam cenários recorrentes no frontend sem sair da lógica do componente.
Quando usar / Quando evitar
Aplicação correta do componente
Quando usar
- Para dashboards e relatórios que já vivem no Power BI e precisam de ser apresentados diretamente no frontend
- Quando o valor está na interatividade, nos filtros, nas várias páginas do relatório ou na atualização contínua do dado
- Para painéis executivos, reporting comercial, métricas operacionais ou contextos de análise com grande componente visual
- Quando existe alinhamento técnico sobre autenticação, permissões e comportamento do embed
Quando evitar
- Quando a página precisa apenas de números estáticos ou uma leitura muito resumida, sem navegação analítica
- Quando o relatório é demasiado complexo para o espaço disponível e acaba ilegível em dispositivos pequenos
- Quando a autenticação, o tenant ou os acessos ainda não estão bem definidos
Como configurar na prática
Sequência de trabalho recomendada
Definir a origem
- Confirmar qual é a Full URL principal e se existe uma Full URL (mobile) própria
- Identificar corretamente Report ID, Group ID e, se aplicável, Client ID
Preparar a experiência
- Decidir se a navegação e o painel de filtros devem estar visíveis através de Nav Content Panel Enabled e Filter Pane Enabled
- Escolher a página de entrada com Page Name e afinar o estado inicial com Report Section ou Bookmark
Ajustar o comportamento
- Configurar Page View, Fullscreen, Autoplay, Chromeless e Action Bar Enabled conforme o contexto
- Usar Filter e Config apenas quando existe uma necessidade concreta e validada
Validar por dispositivo
- Ajustar Iframe Height e Iframe Width para desktop e mobile de forma independente
- Testar legibilidade, scroll interno e comportamento do relatório em ecrãs pequenos
Boas práticas de configuração
Legibilidade, navegação e controlo técnico
Experiência visual
- Nem todos os relatórios funcionam bem num embed estreito; escolhe versões pensadas para o espaço real onde o bloco vai viver
- Se a análise depende de muitos filtros e detalhes, considera dar mais altura ao iframe ou preparar uma página de entrada mais limpa
- Em mobile, uma URL própria costuma melhorar muito a legibilidade
Controlo técnico
- Auto Auth, Client ID e a própria origem do relatório devem ser validados com a equipa técnica antes da publicação
- Campos como Filter, Bookmark e Config ganham valor quando existe um caso de uso claro, não apenas por excesso de parametrização
- Se o relatório já tem demasiada navegação própria, esconder elementos secundários pode ajudar a página a respirar melhor
Configurações avançadas do componente Power BI
Estrutura do bloco e dimensões do iframe
Estas opções controlam a estrutura base do bloco e a forma como o embed ocupa espaço no layout, com dimensões independentes para desktop e mobile.
Estrutura base
- Skin define a variante visual geral do componente
- Disabled block permite desativar o bloco sem o remover
- Block ID e Extra Class são úteis para âncoras, navegação interna e customizações específicas
Espaçamentos
- Margin controla o espaço exterior do bloco
- Padding controla o espaço interior que envolve o embed
- Estes campos ajudam a encaixar relatórios mais densos no ritmo da página sem criar ruído visual
Desktop e mobile
- Iframe Height e Iframe Width existem em secções separadas para desktop e mobile
- Isto permite controlar melhor a legibilidade do relatório consoante o dispositivo
- É muitas vezes aqui que se evita scroll excessivo, cortes indesejados ou uma área de embed demasiado curta
Configuração do conteúdo principal
URL, autenticação, navegação e comportamento do relatório
Na configuração principal defines a origem do relatório, a forma de autenticação, os painéis visíveis, os filtros de arranque e o comportamento geral do embed.
Origem e autenticação
- Full URL e Full URL (mobile) definem o embed por dispositivo
- Report ID, Group ID e Client ID identificam a origem e o contexto técnico do relatório
- Auto Auth pode simplificar o acesso quando existe integração com autenticação do utilizador
Navegação e leitura inicial
- Nav Content Panel Enabled e Filter Pane Enabled controlam a visibilidade dos painéis do próprio Power BI
- Page Name, Report Section e Bookmark ajudam a abrir o relatório num estado editorialmente mais útil
- Filter pode aplicar regras de arranque para mostrar apenas o recorte relevante do dado
Modo de apresentação
- Page View controla a escala visual do relatório, com opções como FitToWidth ou ActualSize
- Fullscreen, Autoplay, Chromeless e Action Bar Enabled definem o tipo de interação disponível
- Config serve para afinações técnicas adicionais quando o projeto pede comportamento mais específico
Guias relacionados
Contexto complementar para este bloco