Configurer le délai d'inactivité de Collabora pour les vues de documents actives

Pour modifier la durée d'inactivité maximale d'une vue Collabora ouverte avant qu'elle ne s'assombrisse et cesse d'être mise à jour, ajustez le paramètre per_view.idle_timeout_secscorrespondant. Le modèle actuel coolwsd.xmlconfigure ce délai au niveau de la vue sur 900 secondes (15 minutes) ; par exemple, configurez-le sur 1800 secondes pour 30 minutes. Il ne s'agit pas du délai de déconnexion ni du délai d'expiration qui décharge un document inactif.

Sachez quel minuteur vous modifiez.

Une vue correspond à l'affichage d'un document dans le navigateur d'un utilisateur. Dans coolwsdle service web qui héberge Collabora Online, ce per_viewparamètre idle_timeout_secsdéfinit le délai d'inactivité (en secondes) avant que la vue d'un utilisateur inactif ne soit grisée et que les mises à jour ne cessent, même si l'onglet du navigateur reste actif. Le modèle par défaut attribue actuellement une valeur de 900 secondes. Votre package ou service géré peut modifier cette valeur ; vérifiez donc la configuration utilisée par votre déploiement.

Utilisez le premier paramètre lorsque les utilisateurs souhaitent que la vue d'édition active reste affichée plus longtemps pendant leur lecture ou une pause. Utilisez le second uniquement si les onglets d'arrière-plan s'assombrissent trop rapidement. Le troisième paramètre correspond au nettoyage côté serveur lorsqu'aucun document n'est actif ; le modifier n'affecte pas le comportement d'inactivité d'une vue restée ouverte. Les paramètres d'enregistrement automatique et d'enregistrement en veille déterminent le moment où le contenu modifié est enregistré, et non la durée d'affichage.

Choisissez un délai d'expiration et préparez la configuration.

Choisissez une durée adaptée à votre flux de travail, puis convertissez-la en secondes : 20 minutes correspondent à 1 200 secondes, 30 minutes à 1 800 secondes et 45 minutes à 2 700 secondes. L’exemple ci-dessous utilise 30 minutes ; il s’agit d’un exemple et non d’une recommandation universelle. Des valeurs plus longues permettent de conserver plus longtemps les vues inactives et peuvent également prolonger la durée des processus de documents et des mises à jour.

Avant toute modification, vérifiez comment Collabora est installé. Docker CODE, un paquet Linux, un déploiement Helm ou un hébergeur peuvent exposer la configuration différemment. Sauvegardez la configuration active ou enregistrez une copie de votre fichier Compose. Si une intégration gère le serveur, utilisez son mécanisme de configuration plutôt que de modifier le système de fichiers temporaire d'un conteneur.

Définir le délai d'inactivité par vue

Code Docker avec Compose

Ajoutez cette option à la extra_paramsvaleur existante du service Collabora :

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

Si extra_paramsdes options sont déjà présentes, ajoutez celle-ci à la même valeur au lieu de définir la clé deux fois. Conservez vos paramètres SSL, proxy et hôte existants. L'image Docker transmet --o:les optionscoolwsd ; la documentation officielle de CODE Docker décrit cette méthode de configuration.

Configuration du paquet Linux ou du XML monté

Modifiez le fichier actif coolwsd.xmlet changez la valeur dans sa <per_view>section existante. Conservez la configuration environnante et tous les attributs de votre fichier :

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

Ne collez pas un deuxième <per_view>bloc et ne modifiez pas le modèle source coolwsd.xml.incomme s'il s'agissait de la configuration en cours d'exécution. Le chemin d'accès au fichier et le propriétaire de la configuration peuvent varier selon le package et le déploiement.

Appliquez le paramètre en redémarrant ou en recréant le service Collabora. Pour un service Compose standard nommé collabora, exécutez :

docker compose up -d --force-recreate collabora

Remplacez le nom du service par celui de votre fichier Compose. Pour une installation de paquet gérée par systemd, redémarrez le service après avoir modifié sa configuration active sudo systemctl restart coolwsd. Rouvrez ensuite le document dans un nouvel onglet de navigateur afin que le test utilise une vue nouvellement créée.

Vérifier le comportement et résoudre les problèmes liés au résultat

1. Ouvrez un document de test à faible risque dans un onglet de navigateur dédié et notez l'heure. Évitez d'utiliser une version de production non enregistrée comme test de délai d'expiration.
2. Laissez la vue inchangée pendant l'intervalle configuré. Au bout de 1 800 secondes, vérifiez si la vue s'assombrit et cesse de recevoir des mises à jour, comme indiqué dans les paramètres spécifiques à chaque vue. Cet état visuel ne signifie pas que l'utilisateur a été déconnecté ou que le document a été déchargé.
3. Retournez au document et vérifiez que ce comportement convient à votre déploiement. Testez ensuite le cas de l'onglet d'arrière-plan séparé en le désactivant pendant une durée supérieure à out_of_focus_timeout_secs, si ce flux de travail est important.

Après un redémarrage, certaines configurations enregistrent une liste de valeurs non standard. Si votre journal de démarrage l'affiche, recherchez-la per_view.idle_timeout_secs: 1800. Si le comportement reste identique à l'ancienne valeur, vérifiez que vous avez bien modifié le fichier ou le service Compose utilisé par le processus en cours d'exécution, que la modification a été appliquée et qu'aucune variable d'environnement ou option de ligne de commande ne remplace le fichier XML.

Si un document disparaît seulement après une longue période sans consultation, per_document.idle_timeout_secsveuillez le vérifier. Si des utilisateurs sont déconnectés, consultez la politique d'authentification ou de session de la plateforme hôte. Ces éléments relèvent de niveaux différents et ne sont pas contrôlés par [nom de la plateforme] per_view.idle_timeout_secs. Ne réduisez pas le délai de déchargement des documents dans le seul but d'assombrir une vue plus rapidement.

Pour connaître les noms des paramètres actuels et les valeurs par défaut en amont, consultez le modèle de configuration de Collabora Online . Pour la méthode Docker extra_params, reportez-vous à la documentation de l'image Docker CODE . Vérifiez le comportement exact en fonction de la version et du packaging que vous utilisez, car les valeurs par défaut et la configuration peuvent varier.