Servicio
Actualizaciones y avisos
Los datos analíticos son una foto, y esta página explica cada cuánto se toma, cómo saber cuándo se tomó la última y qué pasa cuando algo va mal.
Cada cuánto se actualiza#
La frecuencia se acuerda al contratar y la programa Esofitec. Hay tres modalidades:
| Modalidad | Cómo funciona | Para quién |
|---|---|---|
| Diaria | Una carga al día, a la hora fijada | Lo habitual: cuadros de mando de dirección y control |
| Semanal | En los días de la semana elegidos, a la hora fijada | Volúmenes grandes o análisis que se revisan una vez por semana |
| Por minutos | Cada X minutos | Seguimiento casi operativo. Requiere dimensionar el servicio |
La nocturna es la opción por defecto, y por buenas razones
Se ejecuta con la aplicación en calma, tarda menos y no compite con nadie. Antes de pedir más frecuencia, comprueba si tus decisiones de verdad cambian por tener el dato de hace dos horas en vez del de anoche.
Más frecuencia no es gratis
Cada carga consume recursos en el origen y en el destino. Subir a varias diarias es posible, pero se dimensiona y se contrata: no es un interruptor.
Qué ocurre en cada carga#
- Se comprueba qué entidades hay publicadas.
- De cada una se descarta lo que no viaja —campos de control, cálculos, ficheros—.
- Se comprueba si la entidad tiene registros antes de pedirla.
- Se vacía la entidad de destino y se carga la foto nueva.
- Se registra el resultado y se envía el aviso.
Las cargas se ejecutan de una en una. Si por cualquier motivo se solicita una mientras hay otra en marcha, se rechaza y se avisa, en lugar de duplicar trabajo. Ver Arquitectura.
Cómo saber de cuándo son los datos#
Cada ejecución queda registrada en la entidad API_SYNC_LOG, con:
| Dato | Qué dice |
|---|---|
| Inicio y fin | Cuándo empezó y cuándo terminó |
| Duración | Cuánto tardó, en segundos |
| Estado | Cómo acabó |
| Entidades y registros | Cuántas tablas y cuántas filas se cargaron |
| Resumen | El detalle entidad a entidad |
| Mensaje de error | Si lo hubo |
Esa entidad es parte del informe, no solo del servicio
Cárgala en tu modelo y pon una tarjeta con la última actualización correcta. Contesta de antemano la pregunta que siempre llega: «¿esto está actualizado?».
La programación vigente está en API_SYNC_SCHEDULE: frecuencia, hora, días,
intervalo y las marcas de última y próxima ejecución.
Los avisos por correo#
Al terminar cada carga se envía un resumen por correo al equipo técnico y a la persona que designes en tu empresa. En él verás, por entidad:
| Marca | Significado |
|---|---|
| Importada con su número de registros | Todo correcto |
| Sin registros | La entidad estaba vacía. No es un error |
| Aviso de vaciado | Los datos se cargaron, pero el vaciado previo no se completó en esa entidad |
| Error | Esa entidad concreta falló; el resto siguió |
Que una entidad salga vacía es normal
Si no usas el módulo de Calidad, sus entidades estarán vacías todos los días. Conviene saberlo para no perseguir un fallo que no existe.
Un aviso de vaciado merece un vistazo
Significa que la entidad se cargó sobre lo que ya había. Si se repite en las mismas entidades varios días, dínoslo: se corrige en el servicio, no en tu informe.
Cuándo refrescar tu cuadro de mando#
Después de la ventana de carga, con margen. Si la base se actualiza a las 03:00, programa el refresco de Power BI a las 06:00 o 07:00.
Si el informe sale vacío una mañana, mira primero la hora
Casi siempre es un refresco programado demasiado pegado a la carga, no un problema de datos.
Si algo va mal#
| Síntoma | Qué mirar |
|---|---|
| No llegó el correo de resumen | Comprueba el buzón indicado y su carpeta de no deseado; después, avísanos |
| El correo dice que una entidad falló | Los datos de esa entidad son los de la carga anterior; el resto está al día |
| Los datos llevan dos días parados | Mira API_SYNC_LOG: si no hay ejecuciones nuevas, es del servicio y hay que avisar |
| Faltan registros de ayer por la tarde | Entraron después de la última carga. Es el comportamiento esperado |
Para reportar una incidencia, lo que resuelve más rápido: el código de tu solución, la fecha y hora de la carga afectada y el nombre de la entidad.
Qué viene después#
Seguridad y cumplimiento explica qué garantiza este diseño en materia de protección de datos.