Informes que tardan o no llegan a salir: generarlos en segundo plano y elegir el motor de PDF

Cuando un informe tarda tanto que bloquea la pantalla, o directamente no llega a salir, hay dos ajustes distintos que lo arreglan: generarlo en segundo plano y elegir con qué motor se convierte a PDF. Son independientes, se configuran por separado y esta página explica los dos.

Cuándo aplica

• Al pulsar Imprimir la pantalla se queda bloqueada y no se puede seguir trabajando hasta que el informe termina.
• El informe se queda pensando un buen rato y acaba en un error de tiempo agotado, sin llegar a descargarse.
• Un informe muy largo, de cientos de páginas y con el logo de la empresa en la cabecera, falla siempre a partir de cierto tamaño por más veces que se intente.

Configuraciones previas

Para poder realizar dicha acción será necesario:

• Contar con un usuario con permisos para entrar al módulo de Ajustes.
• Activar el modo desarrollador (contactar con el equipo de Astro Hotel si surgen dudas sobre cómo activar el modo desarrollador).

Ajustes > Técnico > Informes

Los campos de esta pantalla todavía se ven en inglés; abajo se indica el nombre tal cual aparece.

Pasos

1º Abrir el informe que da problemas

Desde el módulo de Ajustes, en la opción de Técnico, seleccionar Informes y buscar el informe por su nombre.

2º Marcar que se genere en segundo plano

Activar la casilla Generate in background y guardar. A partir de ese momento, quien imprima ese informe recupera la pantalla al instante y recibe un aviso cuando el documento está listo.

La casilla solo aparece en informes de PDF, Excel y texto. Los informes que se pintan directamente en pantalla no la tienen, porque no bloquean nada y no hay nada que aplazar.

3º Elegir el motor de PDF (opcional)

En el campo PDF engine se puede dejar el valor por defecto de la instalación o forzar uno de los dos:

• wkhtmltopdf: el de siempre.
• Chromium (Gotenberg): el mismo motor que usa un navegador al imprimir. Es el que hay que elegir cuando un informe muy largo con cabecera y pie falla siempre: wkhtmltopdf se queda sin recursos al repetir la cabecera página tras página y termina cortándose, y Chromium no tiene ese problema y además conserva el logo en todas las páginas.

Importante: los dos ajustes son independientes, pero en la práctica van juntos. Chromium solo está disponible donde se ejecutan los informes en segundo plano, así que un informe que no esté marcado como Generate in background seguirá saliendo por wkhtmltopdf aunque se le ponga Chromium. Si se quiere Chromium, hay que marcar también la casilla del paso anterior.

4º Comprobar que el motor está disponible

Pulsar el botón Check engine. Responde si Chromium está realmente disponible o no. Merece la pena hacerlo después de cambiar el motor: si no lo está, el informe seguirá saliendo, pero por wkhtmltopdf y sin avisar.

Resultado esperado

• Al pulsar Imprimir aparece un aviso de que el informe se está generando y la pantalla queda libre para seguir trabajando.
• Cuando termina llega una notificación Report ready con un botón Download para descargarlo.
• Si el informe falla, llega igualmente un aviso en vez de quedarse en silencio.
• El documento generado se guarda 7 días y luego se borra solo. Pasado ese plazo se vuelve a imprimir y se genera de nuevo.
• Solo lo puede descargar quien lo pidió.
• También funciona entrando por un enlace guardado en favoritos o recibido por correo: el informe se encola igual.

Si algo no sale como se espera

• No aparece la casilla: ese informe se pinta en pantalla y no necesita segundo plano.
• Se ha elegido Chromium y el informe sale igual que antes: comprobar con Check engine. Si no está disponible, se usa wkhtmltopdf automáticamente para no dejar a nadie sin su informe.
• El informe sigue muriendo por tiempo: mover el trabajo a segundo plano quita el bloqueo de pantalla, pero no amplía por sí solo el tiempo máximo que puede tardar. Abrir incidencia al equipo de Astro Hotel para que lo revisen en el servidor.
• Se lanzan muchos informes a la vez y tardan en llegar: se generan de uno en uno para no dejar sin recursos al resto del sistema. Es normal que una tanda grande vaya llegando poco a poco.