Compartir Dashboards

Esta guia muestra como compartir dashboards en la UI de Console, incluyendo:

• Enlace publico.
• Enlace restringido por correo.
• Embed para iframe.
• Modos de politica de filtro (open, locked, selectable, disabled) para filtros select y multi_select.

Tipos de Compartir

Tipo	Cuando usar
Enlace publico	Cualquier persona con URL puede acceder
Enlace con correo	Solo correos autorizados pueden acceder
Embed	El dashboard se renderiza dentro de otro producto

Flujo en la UI

1) Abrir dialogo de compartir

1. Abre un dashboard.
2. Haz clic en Compartir.
3. Completa el Nombre del compartir.

2) Definir acceso

• Si Acceso por correo esta vacio: compartir abierto/publico.
• Si agregas correos: el acceso requiere autenticacion externa por codigo.

3) Configurar politicas de filtros (opcional)

Para cada filtro candidato, elige un modo:

• open: el usuario puede elegir valores libremente.
• locked: valor fijo en este share.
• selectable: solo valores permitidos.
• disabled: el filtro no se puede usar en el share.

Opciones Dinamicas de multi_select

Cuando un filtro usa opciones dinamicas via SQL, las vistas compartidas/embed dependen de endpoints de opciones en runtime.

Si el filtro funciona en el dashboard interno pero falla en compartido/embed, verifica:

1. El tipo de filtro es select o multi_select.
2. La consulta dinamica del filtro ejecuta sin error.
3. La politica del share no bloquea el filtro.
4. En flujo portal por correo, context_id se envia correctamente.

Compartir por Correo

Cuando agregas correos en el dialogo:

1. Console crea/vincula un contexto de compartir.
2. El usuario externo recibe codigo de un solo uso por correo.
3. El portal compartido usa token share_access.

Embed

En modo embed, configura:

• allowed_origins.
• hide_header.
• hide_controls.

Usa siempre la embed_url devuelta por la API.

Buenas Practicas

1. Define expiracion para shares sensibles.
2. Prefiere acceso por correo para datos confidenciales.
3. Usa selectable para limitar alcance de filtros.
4. En embed, define allowed_origins para reducir uso indebido.

Solucion de Problemas

Faltan opciones dinamicas del filtro

Prueba el endpoint de opciones segun el modo:

• Publico: /api/v1/public/shares/:token/filters/:filter_slug/options
• Portal/correo: /api/v1/share-portal/.../filters/:filter_slug/options?context_id=...
• Embed: /api/embed/d/:token/filters/:filter_slug/options

DB_QUERY_ERROR

La SQL del filtro dinamico fallo. Revisa SQL, conexion y parametros.

AUTH_REQUIRED

El enlace exige autenticacion externa. El usuario debe iniciar con correo/codigo antes de ejecutar.

Siguientes Pasos

• Guia de Integracion de Compartir (API)
• Guia de Integracion de Embed (API)
• Referencia de Compartir (API)