Pular para o conteúdo principal

Compartilhando Dashboards

Este guia mostra como compartilhar dashboards na interface do Console, incluindo:

  • Link aberto.
  • Acesso restrito por email.
  • Embed para iframe.
  • Regras de filtro (open, locked, selectable) para filtros select e multi_select.

Tipos de Compartilhamento​

TipoQuando usar
Link abertoQuando qualquer pessoa com o link pode acessar
Link com emailQuando somente emails autorizados podem acessar
EmbedQuando o dashboard sera incorporado em outro sistema

Fluxo na UI​

1) Abrir dialogo de compartilhamento​

  1. Entre no dashboard.
  2. Clique em Compartilhar.
  3. Defina o Nome do compartilhamento.

2) Definir o nivel de acesso​

  • Se Acesso por email ficar vazio: compartilhamento aberto.
  • Se voce adicionar emails: o acesso passa a exigir autenticacao externa por codigo.

3) Configurar regras de filtros (opcional)​

Para cada filtro candidato, escolha um modo:

  • open: usuario pode escolher livremente.
  • locked: valor fixo no compartilhamento.
  • selectable: usuario escolhe apenas entre valores permitidos.
  • disabled: filtro nao pode ser usado no compartilhamento.

Filtros multi_select com opcoes dinamicas​

Quando o filtro usa consulta dinamica (SQL), o compartilhamento depende dos endpoints de opcoes para carregar valores em runtime.

Se o filtro aparece no dashboard interno, mas nao no compartilhado/embed, verifique:

  1. O filtro e select ou multi_select.
  2. A consulta dinamica do filtro retorna dados sem erro.
  3. A regra de compartilhamento nao bloqueou o filtro (disabled ou locked com hide_when_locked=true).
  4. No portal por email, context_id esta sendo enviado corretamente.

Compartilhamento por Email​

Quando voce informa emails no dialogo:

  1. O Console cria/vincula um contexto de compartilhamento.
  2. O usuario externo recebe codigo por email (fluxo passwordless).
  3. O acesso ao portal compartilhado usa token share_access.

Quem Pode Compartilhar​

Um usuario comum do Console nao compartilha dashboards apenas por conseguir abrir o recurso. Ele precisa das actions de share compativeis com o que esta administrando:

Acao na UI/APIPermissao minima
Abrir Compartilhar em dashboard e criar/revogar linkdashboards:share
Gerar embed de dashboarddashboards:share
Gerenciar emails, membros e share-contexts de dashboarddashboards:share
Gerar embed de visualizacaovisualizations:share
Gerenciar contexto misto (dashboard + visualizacao)dashboards:share e visualizations:share

Se a permissao faltar, a UI nao deve expor o fluxo e a API respondera 403 FORBIDDEN.

Embed​

No modo embed, configure:

  • allowed_origins (origens permitidas).
  • hide_header.
  • hide_controls.

Use a embed_url retornada pela API e nao monte a URL manualmente.

Boas Praticas​

  1. Use expiracao para compartilhamentos sensiveis.
  2. Prefira acesso por email para dados confidenciais.
  3. Restrinja filtros com selectable quando precisar limitar escopo.
  4. Em embed, defina allowed_origins para reduzir risco de uso indevido.

Solucao de Problemas​

Filtro dinamico nao carrega no compartilhado​

  • Teste o endpoint de opcoes do modo em uso:
    • Publico: /api/v1/public/shares/:token/filters/:filter_slug/options
    • Portal/email: /api/v1/share-portal/.../filters/:filter_slug/options?context_id=...
    • Embed: /api/embed/d/:token/filters/:filter_slug/options

Erro DB_QUERY_ERROR​

A consulta SQL do filtro dinamico falhou. Revise SQL, conexao e parametros.

Erro AUTH_REQUIRED​

O link exige autenticacao externa. O usuario deve entrar com email/codigo antes de executar.

Erro FORBIDDEN​

O usuario interno nao tem a action dashboards:share ou visualizations:share exigida pelo endpoint de compartilhamento/embed.

Proximos Passos​

Última atualização em