Selo de estado:
Preview(teto atual do produto) · Curso ACD-340 — Publicação, distribuição, RLS e BI-as-code · Aula 2 de 8 · Atualizado em 2026-10-04.
Objetivo#
Ao final desta aula você vai escolher e desligar exposição.
Vídeo#
Identificador no manifesto: acd-340-02-tres-formas-de-compartilhar · duração-alvo 7 min · tela do produto: /dashboards.
Roteiro (capítulos):
- 00:00–00:50 — Três endereços, uma decisão: exposição, não detalhe técnico (
/dashboards). - 00:50–02:30 —
/d/<slug>: o link privado padrão,noindex, sem senha/expiração (/dashboards/[id]/compartilhar). - 02:30–04:30 —
/painel/<slug>: ligar Publicar na web de propósito, e o redirecionamento de/dquando você liga. - 04:30–06:00 —
/r/<slug>: o snapshot congelado que nasce de um relatório agendado. - 06:00–07:00 — Erros comuns e encerramento.
Conteúdo#
Compartilhar um painel no ingestia.bi não é uma única decisão — são três, cada uma com um nível de exposição diferente. A pergunta nunca é "como eu compartilho", porque tecnicamente é fácil; a pergunta é "quem deve conseguir ver isso, e para sempre ou só agora". O produto materializa essa escolha em três endereços distintos, não em uma única URL com uma opção "pública: sim/não".
Como aparece no produto. Tudo começa em Compartilhar (/dashboards/[id]/compartilhar), a tela que reúne as portas de exposição de um painel já publicado (veja a Aula 1 se o seu painel ainda só existe em rascunho). A primeira porta, e a que o produto trata como padrão, é o link secreto: um endereço /d/<slug> com um trecho aleatório não-adivinhável. Ele é noindex — o robots.txt do site nem deixa um buscador entrar — e serve um snapshot já materializado, então abrir o link não custa nada e não dispara nenhuma consulta nova. A segunda porta é a web aberta: um toggle explícito chamado Publicar na web, que fica desligado por padrão. Enquanto ele estiver desligado, /painel/<slug> simplesmente não existe (dá 404) — mesmo que o painel já tenha um link /d ativo há meses. No momento em que alguém liga esse toggle, o endereço /painel/<slug> passa a ser indexável, rastreável por buscadores, e vira o endereço canônico: o /d/<slug> antigo continua funcionando, mas agora redireciona para /painel/<slug>, para não existirem duas URLs públicas com o mesmo conteúdo. A terceira porta nem mora no Compartilhar: /r/<slug> é o endereço de um snapshot de relatório, e só existe depois que um relatório agendado roda pelo menos uma vez (é conteúdo da Aula 5). Ele é imutável — o número que foi enviado é o número que fica gravado na página, para sempre, mesmo que o painel de origem mude depois.
Exemplo Aurora. A diretoria da Comércio Aurora Ltda acompanha "Vendas por filial" por um link /d/<slug> que maria mandou por e-mail — ninguém fora da empresa tem o endereço, e o link não aparece em nenhuma busca. Já o painel "Receita por categoria — resultado público do trimestre", que a Aurora decidiu divulgar para fornecedores e para o site institucional, tem Publicar na web ligado de propósito: é /painel/receita-aurora-t3, indexável, feito para ser encontrado. E quando sai o e-mail semanal "Resumo semanal" (assinatura da Aula 5), o link dentro do e-mail é um /r/<slug>: mesmo que o painel de origem mude na semana seguinte, quem abrir aquele e-mail antigo sempre vai ver o número congelado que foi enviado naquele dia — "o número enviado é o número da página".
Erros comuns. O primeiro é publicar na web aberta sem querer: como o botão de publicar um rascunho (Aula 1) e o toggle Publicar na web usam palavras parecidas, é fácil alguém achar que está só "soltando a versão nova" e, na verdade, estar abrindo o painel para o mundo inteiro, indexável. A regra de ouro: Publicar na web é sempre um ato deliberado, nunca um efeito colateral — se você não decidiu conscientemente divulgar aquele painel, não ligue o toggle. O segundo erro, mais sutil, é colar um link /d num grupo de WhatsApp (ou numa lista de transmissão grande): como o link não exige login e é permanente por design — sem senha, sem expiração hoje —, qualquer pessoa que já passou por aquele grupo (inclusive quem foi removido depois) continua com acesso enquanto tiver o endereço salvo, e um encaminhamento tira o link do seu controle por completo. Prefira mandar /d só pessoalmente, para quem realmente deveria ter acesso; se o objetivo era avisar um grupo grande, o endereço certo é a web aberta (opt-in, auditada) ou uma assinatura por e-mail com RLS (Aula 5).
Estado do produto. /d e /painel compartilham o mesmo snapshot seguro — PII sempre mascarada, sem custo de consulta para o visitante — mas o teto de maturidade é Preview: hoje não há senha nem expiração opcionais no link privado, e a entrega/renderização em produção é "NÃO MEDIDO". A web aberta e o embed (Aula 8) dependem de infraestrutura paga e de uma allowlist ainda global por ambiente, não por workspace — mais um motivo para tratar Publicar na web como decisão consciente, não automática.
/d/<slug> | /painel/<slug> | /r/<slug> | |
|---|---|---|---|
| O que é | link privado, não-adivinhável | painel público, web aberta | snapshot imutável de relatório |
| Indexação | noindex | indexável, rastreável | noindex |
| Fonte do dado | snapshot materializado | snapshot materializado | resultado congelado no envio |
| Como liga | porta padrão em Compartilhar | toggle Publicar na web (opt-in) | nasce do primeiro envio de um relatório agendado |
| Custo ao visitante | zero (sem query nova) | zero | zero |
| PII | sempre mascarada | sempre mascarada | sempre mascarada (gravada já sanitizada) |
Faça você mesmo#
No workspace de treino Aurora Varejo (abra /dashboards no console):
- Abra um painel publicado e vá em Compartilhar.
- Copie o link secreto
/d/<slug>e abra-o numa aba anônima — confirme que carrega sem exigir login. - Ligue Publicar na web e confirme que o mesmo painel passa a responder em
/painel/<slug>. - Abra de novo o link
/d/<slug>original na aba anônima e confirme que ele redireciona para/painel/<slug>. - Desligue Publicar na web de novo e confirme que
/painel/<slug>volta a dar 404, enquanto/d/<slug>continua funcionando. - Se o workspace de treino já tiver um relatório agendado configurado (veja a Aula 5), dispare um envio e localize o link
/r/<slug>gerado; se não tiver, crie um relatório simples na aba de relatórios do Compartilhar só para gerar o primeiro snapshot. - Abra o
/r/<slug>e confirme que ele mostra um número, não um painel interativo — é a leitura congelada daquele envio.
Você terminou quando conseguir explicar, para uma pessoa não-técnica, a diferença entre "mandar o link" (/d), "divulgar de propósito" (/painel) e "o número que foi enviado naquele dia" (/r).
Checagem rápida#
Três perguntas no final da aula, corrigidas no servidor. A aula só conta como concluída depois da checagem.
Documentação relacionada#
Capacidades ensinadas#
(conceitual — sem capacidade específica da matriz) — o selo exibido na aula é sempre o estado mais conservador entre as capacidades citadas; nada aqui é "GA".