Cadastrar dashboards

Onde obter os identificadores no Power BI Service, o que cada campo do formulário faz e como escolher o modo de incorporação.

Atualizado em 11 de setembro de 2026

O cadastro fica em Administração › Dashboards. Antes de começar, garanta que as credenciais do Power BI já estão configuradas — sem elas nada renderiza. Veja Power BI e Azure.

Há duas formas de trazer relatórios: a importação automática (workspaces inteiros de uma vez) e o cadastro manual (formulário “Novo Dashboard”, o resto desta página). As duas convivem — a automática cobre o workspace de produção, a manual serve pra relatórios avulsos de outros workspaces. Se a sua ideia é espelhar um workspace inteiro, comece por importação automática de relatórios; esta página cobre o cadastro relatório a relatório.

Campos do formulário

CampoO que é
NomeTítulo exibido na barra lateral
DescriçãoTexto de apoio, opcional
Workspace IDIdentificador do workspace no Power BI
Report IDIdentificador do relatório
MenuAgrupador onde o dashboard aparece
Modo de incorporaçãoComo o token de acesso é gerado
Mostrar navegador de páginasLiga a barra lateral de páginas do relatório, no estilo do portal

Onde encontrar os identificadores

Abra o relatório no Power BI Service e observe a URL:

https://app.powerbi.com/groups/<WORKSPACE_ID>/reports/<REPORT_ID>/ReportSection

O primeiro identificador após /groups/ é o Workspace ID; o que vem após /reports/ é o Report ID. Ambos são cadeias no formato UUID.

Cuidado com dois enganos frequentes: copiar o identificador do dataset em vez do relatório, e usar a URL de um relatório no espaço pessoal (My Workspace), que não funciona com Service Principal.

Selecione em qual menu o dashboard aparece. Menus precisam existir antes — crie-os em menus.

Modo de incorporação

Duas opções, com implicações bem diferentes.

Service Principal (App Owns Data) — o padrão e o recomendado. A plataforma se autentica como aplicação e gera um token específico para o relatório. Nenhum usuário final precisa de licença Power BI.

Master User (conta compartilhada) — a plataforma autentica com e-mail e senha de uma conta real do Power BI. Exige que essa conta tenha licença e não tenha autenticação multifator habilitada. É um modo de contorno, para cenários em que o Service Principal não pôde ser liberado.

Escolha Service Principal salvo impedimento concreto. A conta Master User é um ponto único de falha: se a senha expirar, se alguém habilitar MFA nela ou se ela for desativada, todos os dashboards dessa organização param.

Desligado por padrão. Quando ligado, o dashboard passa a exibir, à esquerda do relatório, uma barra listando as páginas do Power BI — desenhada com a identidade visual do portal, não o painel nativo do Power BI Service. O usuário pode ocultá-la e reexibi-la pelo botão no canto do painel; a navegação em si usa a própria API do relatório, então continua sincronizada mesmo se o usuário trocar de página por dentro do relatório (um botão de “voltar”, por exemplo).

Páginas ocultas no modo de visualização (configuradas assim no Power BI Desktop) não aparecem na lista, e a barra some sozinha se o relatório tiver só uma página visível — não há o que navegar nesse caso.

Vale para relatórios com várias páginas que fazem sentido como navegação (ex.: um relatório com uma página por regional). Para relatórios de página única, deixe desligado.

Permissão de acesso

O cadastro não define sozinho quem vê o dashboard. A visibilidade vem dos perfis de acesso: cada perfil seleciona os dashboards que enxerga, na aba Dashboards.

Um dashboard recém-cadastrado não aparece para ninguém que não seja administrador até ser incluído em ao menos um perfil. Veja perfis e permissões.

Segurança em nível de linha

Se o relatório aplica segurança por linha (RLS) no modelo de dados do Power BI, os nomes das roles são informados no perfil de acesso, na aba Geral, campo Papéis Power BI.

As roles precisam existir com o mesmo nome no modelo de dados publicado. Nome divergente resulta em erro na geração do token.

Checklist de publicação

  1. Credenciais do Power BI configuradas e testadas
  2. Menu criado
  3. Workspace ID e Report ID copiados da URL do relatório
  4. Modo de incorporação escolhido
  5. Navegador de páginas ligado, se o relatório tiver mais de uma página que faça sentido navegar
  6. Dashboard incluído nos perfis de acesso que devem enxergá-lo
  7. Teste feito com um usuário não administrador