Del dato al portal
Una factura que aparece en el portal de tu cliente nació en tu sistema — un ERP, una base de datos, una API. Esta página muestra el camino que recorre ese dato hasta la pantalla, y dónde configuras cada paso.
El camino
- Conector — la conexión con tu sistema: la dirección, las credenciales y las operaciones que ofrece (por ejemplo, Listar facturas). Configúralo en Conectores.
- Entidad — un tipo de dato que el portal muestra, como Factura. La entidad dice qué operación del conector trae los registros, qué campos tiene cada registro y qué campo indica el titular — de quién es el registro. Guarda una copia de los registros en Dashboard Mágico. Configúrala en Entidades.
- Bloque — en el Constructor, armas las páginas con bloques: una tabla de facturas, el detalle de una factura, una lista de notas fiscales para descargar. Cada bloque de datos lee los registros de una entidad. Mira Datos en los bloques.
- Página publicada — el portal muestra la versión que publicaste. Los cambios en el borrador solo aparecen después de publicar. Mira Publicar y versiones.
- Usuario del portal — quien entra al portal ve solo los registros cuyo titular es igual a su tenant ID. Mira Titular y tenant ID y Usuarios del portal.
El portal lee la copia, no tu sistema
Cuando el usuario abre una página, los bloques leen los registros que la entidad ya guardó. El portal no consulta tu sistema en cada visita — incluso con la sincronización Cuando el usuario accede, solo busca de nuevo cuando los registros guardados pasan del plazo. Por eso:
- el portal sigue siendo rápido aunque tu sistema sea lento;
- una inestabilidad en tu sistema no tumba el portal — muestra los datos de la última sincronización;
- un dato nuevo solo aparece en el portal después de la próxima sincronización de la entidad.
Cuándo se actualizan los datos
Cada entidad elige cómo se sincroniza con tu sistema:
| Sincronización | Cómo funciona |
|---|---|
| Programada | Lee todos los registros cada cierto tiempo, en el horario definido en el conector. También se puede pedir una sincronización en el momento. |
| Manual | Lee todos los registros solo cuando lo pides. |
| Cuando el usuario accede | Lee solo los registros del tenant ID de quien está en el portal, cuando la persona entra y cuando abre una página con esa entidad. Los registros valen por un tiempo que tú eliges (de 5 minutos a 24 horas); pasado ese plazo, el siguiente acceso busca de nuevo, mostrando entretanto los registros guardados. En la primera búsqueda, cuando todavía no hay nada guardado, el bloque muestra Buscando tus datos…. |
Los detalles están en Sincronización de las entidades.
Ejemplo
En Aurora Energia:
- El conector ERP Aurora Energia conecta Dashboard Mágico con la API del ERP y se sincroniza cada 2 horas.
- La entidad Factura usa la operación Listar facturas y marca el campo CPF/CNPJ del titular como titular.
- La página Facturas del Constructor tiene una tabla de la entidad Factura, con las pestañas Por pagar, Pagadas y Todas.
- La página se publicó.
- Una clienta entra al portal y ve, en la página Facturas, solo las facturas de su CPF.
Más allá de mostrar datos
El camino también vale en sentido contrario, en dos casos:
- Usuarios a partir de una entidad — una entidad puede crear los usuarios del portal: cada registro se convierte en un usuario, con el correo y el tenant ID tomados de los campos que elijas. Mira Usuarios del portal.
- Botones y formularios — un bloque de acción o de formulario puede enviar datos hacia afuera (un webhook o un correo). Mira Formularios y acciones.