Configura el temporizador de inactividad de Collabora para las vistas de documentos activas.

Para cambiar el tiempo que una vista de Collabora abierta puede permanecer inactiva antes de atenuarse y dejar de recibir actualizaciones, ajuste este valor per_view.idle_timeout_secs. La plantilla actual coolwsd.xmlestablece este temporizador de vista en 900 segundos (15 minutos); por ejemplo, configúrelo en 1800 para 30 minutos. Este no es un temporizador de cierre de sesión ni el tiempo de espera que descarga un documento inactivo.

Sepa qué temporizador está cambiando

Una vista es la visualización de un documento en el navegador de un usuario. En coolwsdCollabora Online, el demonio web que sirve a Collabora Online, la per_viewconfiguración idle_timeout_secsdefine el número de segundos antes de que la vista de un usuario inactivo se atenúe y se detengan las actualizaciones, incluso mientras la pestaña del navegador permanezca activa. La plantilla predeterminada establece un valor de 900 segundos. Su paquete o servicio gestionado puede anular este valor, por lo que debe verificar la configuración que utiliza su implementación.

Utilice la primera configuración cuando desee que la vista de edición enfocada permanezca visible durante más tiempo mientras lee o hace una pausa. Utilice la segunda solo si las pestañas en segundo plano se atenúan demasiado pronto. La tercera opción realiza una limpieza en el servidor cuando un documento no tiene vistas activas; al modificarla, no se altera el comportamiento de inactividad de una vista que permanece abierta. Las configuraciones de guardado automático y guardado en reposo controlan cuándo se guarda el contenido modificado, no cuánto tiempo permanece activa una vista.

Elija un tiempo de espera y prepare la configuración.

Selecciona una duración que se ajuste a tu flujo de trabajo y conviértela a segundos: 20 minutos equivalen a 1200, 30 minutos a 1800 y 45 minutos a 2700. El ejemplo que se muestra a continuación utiliza 30 minutos; es solo un ejemplo, no una recomendación general. Valores más largos mantienen las vistas inactivas activas durante más tiempo y pueden conservar los procesos de documentos y la actividad de actualización durante más tiempo.

Antes de editar, identifique cómo está instalado Collabora. Docker CODE, un paquete de Linux, una implementación de Helm y un proveedor de alojamiento pueden exponer la configuración de manera diferente. Realice una copia de seguridad de la configuración activa o guarde una copia de su archivo Compose. Si una integración administra el servidor, utilice su mecanismo de configuración compatible en lugar de editar el sistema de archivos temporal de un contenedor.

Establezca el tiempo de espera de inactividad por vista.

Docker CODE con Compose

Agregue la opción al extra_paramsvalor existente para el servicio Collabora:

services:
  collabora:
    environment:
      extra_params: "--o:per_view.idle_timeout_secs=1800"

Si extra_paramsya contiene opciones, agréguela al mismo valor en lugar de definir la clave dos veces. Mantenga su configuración existente de SSL, proxy y host. La imagen de Docker pasa --o:opciones a coolwsd; la documentación oficial de CODE Docker describe este método de configuración.

Paquete de Linux o configuración XML montada

Edita el coolwsd.xmlarchivo activo y cambia el valor dentro de su <per_view>sección existente. Conserva la configuración circundante y cualquier atributo en tu archivo:

<per_view>
  <out_of_focus_timeout_secs>300</out_of_focus_timeout_secs>
  <idle_timeout_secs>1800</idle_timeout_secs>
</per_view>

No pegue un segundo <per_view>bloque ni edite la plantilla de origen coolwsd.xml.incomo si fuera la configuración en ejecución. La ruta de archivo correcta y el propietario de la configuración pueden variar según el paquete y la implementación.

Aplique la configuración reiniciando o recreando el servicio Collabora. Para un servicio Compose típico llamado collabora, ejecute:

docker compose up -d --force-recreate collabora

Reemplace el nombre del servicio con el que aparece en su archivo Compose. Para una instalación de paquete gestionada por systemd, reinicie el servicio después de editar su configuración activa, por ejemplo sudo systemctl restart coolwsd. Vuelva a abrir el documento en una pestaña nueva del navegador para que la prueba utilice una vista recién creada.

Verificar el comportamiento y solucionar el problema.

1. Abra un documento de prueba de bajo riesgo en una pestaña activa del navegador y anote la hora. Evite usar una edición de producción sin guardar como prueba de tiempo de espera.
2. Deje la vista sin modificar durante el intervalo configurado. A los 1800 segundos, compruebe si la vista se atenúa y deja de recibir actualizaciones, tal como se describe en la configuración por vista. No interprete este estado visual como prueba de que el usuario ha cerrado sesión o de que el documento se ha descargado.
3. Vuelva al documento y confirme que el comportamiento es aceptable para su implementación. Luego, pruebe el caso de la pestaña en segundo plano por separado cambiando a otra pestaña durante más tiempo out_of_focus_timeout_secs, si ese flujo de trabajo es relevante.

Tras reiniciar, algunas compilaciones registran una lista de valores de configuración no predeterminados. Si el registro de inicio muestra esta lista, busque per_view.idle_timeout_secs: 1800. Si el comportamiento sigue siendo el mismo que el valor anterior, verifique que haya editado el archivo o el servicio Compose utilizado por el proceso en ejecución, que haya aplicado el cambio y que ninguna opción de entorno o de línea de comandos esté sobrescribiendo el XML.

Si un documento desaparece solo después de un período prolongado sin vistas abiertas, revíselo per_document.idle_timeout_secs. Si los usuarios cierran sesión, verifique la política de autenticación o de sesión de la plataforma anfitriona. Estas son capas diferentes y no están controladas por per_view.idle_timeout_secs. No acorte la configuración de descarga del documento solo para que una vista se atenúe antes.

Para conocer los nombres de configuración actuales y los valores predeterminados, consulte la plantilla de configuración de Collabora Online . Para el método de Docker extra_params, consulte la documentación de la imagen de Docker de CODE . Verifique el comportamiento exacto con la versión y el empaquetado que utilice, ya que los valores predeterminados y la configuración pueden variar.