Portail ZAPP ejecuta en segundo plano tareas planificadas (llamadas «trabajos» en pantalla): envío de la cola de notificaciones, sincronizaciones de directorio, recopilaciones de los conectores, vigilancia de plazos, etc. Cada tarea la aporta un módulo; la pantalla Planificador sirve para elegir cuándo se ejecutan, lanzarlas a mano y comprobar su resultado.
La pantalla Planificador (menú Administración › Instancia y operaciones › Planificador) está reservada a los Administradores.
La lista de tareas
Cada fila muestra el Nombre de la tarea, su Categoría, su Descripción, sus Disparadores (las programaciones activas), su Estado (Activo, Desactivado o En ejecución), la fecha de Última ejecución y su Resultado.
Desde esta pantalla no se crean ni se eliminan tareas: aparecen con los módulos que las aportan. Algunas se entregan desactivadas porque antes requieren una configuración (por ejemplo, una sincronización de directorio): actívalas una vez hecha esa configuración.
Cuando el módulo Cuadrículas de datos está instalado, la lista es una cuadrícula: selecciona una fila y usa los botones Ejecutar ahora, Activar, Desactivar o Detalles de la barra de herramientas. Sin cuadrícula, Detalles abre la ficha de la tarea.
La ficha de una tarea
La tarjeta Estado recuerda la categoría, el estado, la última ejecución y su resultado, con dos acciones:
- Activar / Desactivar: una tarea desactivada deja de lanzarse sola, tenga los disparadores que tenga;
- Disparar ahora: lanza la tarea de inmediato, aunque esté desactivada. El botón aparece atenuado (En ejecución) mientras no termine la ejecución en curso: una misma tarea nunca se ejecuta dos veces en paralelo. La ejecución se hace en segundo plano; recarga la página para ver su resultado.
Algunas tareas genéricas muestran también una tarjeta Parámetros: un texto JSON que se pasa a la tarea en cada ejecución. Guardar lo registra tal cual, sin control de formato: revísalo antes de guardar.
La tarea que llama a una URL (parámetro url) alcanza una dirección pública o una máquina de tu red privada. Rechaza las direcciones reservadas (enlace local, dirección de metadatos de un proveedor de nube como 169.254.169.254, multidifusión) así como localhost, salvo cuando la URL apunta a la propia aplicación: misma dirección base (protocolo, nombre y puerto), o localhost en un puerto en el que escucha la aplicación. Los demás servicios de la máquina (localhost en otro puerto) siguen rechazados. Hacia otra dirección, una redirección se sigue y se controla del mismo modo; hacia la propia aplicación, solo se siguen las redirecciones que se quedan en la aplicación. Una llamada rechazada aparece en el historial con el mensaje Llamada rechazada.
Los disparadores
Un disparador es una expresión CRON que indica cuándo arranca la tarea. Una tarea puede tener varios; arranca en cuanto vence cualquiera de ellos.
- Para añadir uno, escribe un Nombre y una expresión CRON y pulsa + Añadir disparador. El botón Asistente CRON (icono a la derecha del campo) compone la expresión por ti; Aplicar la copia en el campo.
- Editar cambia el nombre, la expresión y la casilla Activo de un disparador; Eliminar lo borra tras confirmación.
Conviene saber:
- la expresión tiene seis campos, el primero son los segundos:
0 0/10 * * * *significa «cada 10 minutos»,0 30 2 * * *«cada día a las 2:30». Una expresión no válida se rechaza y se muestra un mensaje de error; - los disparadores creados desde esta pantalla siguen la hora UTC, no la hora local: tenlo en cuenta para una tarea a hora fija;
- el planificador comprueba los vencimientos una vez por minuto: una tarea nunca arranca más de una vez por minuto, y un vencimiento perdido mientras la aplicación estaba detenida no se recupera (salvo para las pocas tareas previstas para recuperarse al arrancar).
El historial de ejecución
Historial de ejecución lista las últimas ejecuciones, con la hora de inicio, la Duración, el Estado, las Estadísticas que aporta la tarea (número de elementos tratados, por ejemplo) y el Error si lo hay. Solo se conservan las 20 últimas ejecuciones de cada tarea.
El estado se muestra en su forma técnica: Success (correcta), PartialSuccess (correcta en parte), Error (fallida), Running (en curso) o Skipped (no lanzada: durante una ventana de blackout, o porque el módulo de la tarea no está disponible). Un vencimiento no lanzado no se recupera después.
Una ventana de blackout es un periodo, puntual o recurrente (días de la semana y franja horaria), durante el cual no se dispara ninguna tarea programada. Se gestiona por la API del planificador (GET y POST /api/v1/scheduler/blackout-windows, DELETE /api/v1/scheduler/blackout-windows/{id}); la pantalla de estado de la instancia solo señala la que está en curso.
Si la aplicación se detiene durante una ejecución, la tarea se restablece al reiniciar y vuelve a arrancar en su siguiente vencimiento.
Cuando una tarea falla, la columna Error explica la causa en tu idioma; la API y las exportaciones reciben un código estable seguido de una frase en inglés. El mensaje técnico (que puede nombrar un servidor, un archivo o una consulta) queda en el registro del servidor. Causas comunes a todas las tareas:
| Código | Causa | Qué hacer |
|---|---|---|
DatabaseUnavailable |
La base de datos no respondió o rechazó la conexión (servidor detenido, red, tiempo de espera, demasiadas conexiones) | Comprobar el servidor de base de datos y volver a ejecutar la tarea |
DatabaseError |
La base de datos rechazó la solicitud | Consultar el registro del servidor |
Timeout |
Una operación de la tarea no terminó a tiempo | Volver a ejecutar la tarea; consultar el registro del servidor si se repite |
RemoteServiceUnreachable |
Un servicio remoto no respondió o rechazó la conexión (dirección, red, certificado) | Consultar el registro del servidor |
RemoteServiceError |
Un servicio remoto respondió con un error (estado HTTP indicado) | 401 o 403: cuenta rechazada; 404: dirección incorrecta; 5xx: fallo del servicio. Consultar el registro del servidor |
Una tarea que ejecuta una consulta guardada indica, cuando falla, la consulta afectada: el motivo exacto está en su registro de ejecución (módulo Consultas).
Cualquier otro error imprevisto se muestra como «Error inesperado» con su tipo. Las causas propias de una tarea (conectores, scripts, sincronizaciones) se describen en la página de su módulo.
Exportar e importar la planificación
- Exportar la planificación descarga un archivo JSON con, para cada tarea, su nombre, su estado (activa o no) y sus disparadores. Los parámetros JSON no se exportan.
- Importar la planificación carga un archivo así. Las tareas se reconocen por su nombre; una tarea que no existe en esta instancia se ignora, no se crea ninguna. Marca Sobrescribir la planificación existente (disparadores reemplazados) para aplicar el archivo: se toma del archivo el estado de cada tarea reconocida y sus disparadores se sustituyen por los del archivo. Sin esta casilla, la importación no cambia nada.
Es la forma de trasladar una planificación ajustada en una instancia de pruebas a otra instancia.
Ver también
- «Configurar los permisos»: quién puede abrir el Planificador.
- Las páginas de los módulos que aportan tareas (sincronizaciones de directorio, conectores) describen lo que hace cada una.