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

Tipo	Quando usar
Link aberto	Quando qualquer pessoa com o link pode acessar
Link com email	Quando somente emails autorizados podem acessar
Embed	Quando 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.

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.

Proximos Passos

• Integracao de Compartilhamento (API)
• Integracao de Embed (API)
• Referencia de Compartilhamento (API)