Defina o temporizador de inatividade do Collabora para visualizações de documentos ativos.

Para alterar o tempo que uma visualização do Collabora aberta pode permanecer inativa antes de escurecer e parar de receber atualizações, ajuste o valor de ` setTimeout` per_view.idle_timeout_secs. O modelo atual coolwsd.xmldefine esse temporizador de nível de visualização para 900 segundos (15 minutos); por exemplo, defina-o para 1800 para 30 minutos. Este não é um temporizador de logout nem o tempo limite que descarrega um documento ocioso.

Saiba qual temporizador você está alterando.

Uma visualização é a visão de um usuário sobre um documento em seu navegador. No coolwsdCollabora Online, o daemon web que o serve, essa per_viewconfiguração idle_timeout_secsdefine o número de segundos antes que a visualização de um usuário inativo seja esmaecida e as atualizações sejam interrompidas, mesmo que a aba do navegador permaneça em foco. O modelo padrão atualmente define um valor de 900 segundos. Seu pacote ou serviço gerenciado pode substituir esse valor, portanto, verifique a configuração realmente usada em sua implementação.

Use a primeira configuração quando os usuários desejarem que a visualização de edição em foco permaneça ativa por mais tempo enquanto leem ou pausam. Use a segunda somente se as guias em segundo plano escurecerem muito rapidamente. A terceira configuração realiza a limpeza no servidor após um documento não ter mais visualizações ativas; alterá-la não modifica o comportamento de inatividade de uma visualização que permanece aberta. As configurações de salvamento automático e salvamento em modo ocioso controlam quando o conteúdo modificado é salvo, não por quanto tempo uma visualização permanece ativa.

Escolha um tempo limite e prepare a configuração.

Escolha uma duração que se adeque ao seu fluxo de trabalho e, em seguida, converta-a para segundos: 20 minutos equivalem a 1200, 30 minutos a 1800 e 45 minutos a 2700. O exemplo abaixo usa 30 minutos; trata-se apenas de um exemplo, não de uma recomendação universal. Valores mais longos mantêm as visualizações ociosas ativas por mais tempo e podem também reter os processos de documentos e a atividade de atualização por mais tempo.

Antes de editar, identifique como o Collabora está instalado. O Docker CODE, um pacote Linux, uma implantação Helm e um provedor de hospedagem podem expor a configuração de maneiras diferentes. Faça backup da configuração ativa ou salve uma cópia do seu arquivo Compose. Se uma integração gerencia o servidor para você, use o mecanismo de configuração compatível com ela em vez de editar o sistema de arquivos temporário de um contêiner.

Defina o tempo limite de inatividade por visualização.

Docker CODE com Compose

Adicione a opção ao extra_paramsvalor existente para o serviço Collabora:

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

Se extra_paramsjá existirem opções, adicione esta com o mesmo valor em vez de definir a chave duas vezes. Mantenha suas configurações existentes de SSL, proxy e host. A imagem Docker passa --o:opções para coolwsd; a documentação oficial do Docker da CODE descreve esse método de configuração.

Pacote Linux ou configuração XML montada

Edite o coolwsd.xmlarquivo ativo e altere o valor dentro da <per_view>seção existente. Preserve a configuração circundante e quaisquer atributos no seu arquivo:

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

Não cole um segundo <per_view>bloco nem edite o modelo de origem coolwsd.xml.incomo se fosse a configuração em execução. O caminho correto do arquivo e o proprietário da configuração podem variar de acordo com o pacote e a implantação.

Aplique a configuração reiniciando ou recriando o serviço Collabora. Para um serviço Compose típico com o nome collabora, execute:

docker compose up -d --force-recreate collabora

Substitua o nome do serviço pelo nome presente no seu arquivo Compose. Para uma instalação de pacote gerenciada pelo systemd, reinicie o serviço após editar sua configuração ativa, por exemplo sudo systemctl restart coolwsd. Reabra o documento em uma nova aba do navegador para que o teste utilize uma visualização recém-criada.

Verificar o comportamento e solucionar problemas resultantes

1. Abra um documento de teste de baixo risco em uma aba do navegador em foco e anote o horário. Evite usar uma edição de produção não salva como teste de tempo limite.
2. Deixe a visualização inalterada durante o intervalo configurado. Após 1800 segundos, verifique se a visualização escurece e para de receber atualizações, conforme descrito na configuração por visualização. Não interprete esse estado visual como prova de que o usuário foi desconectado ou que o documento foi descarregado.
3. Volte ao documento e confirme se o comportamento é aceitável para sua implementação. Em seguida, teste o caso da guia de fundo separada, alternando para outra guia por um período maior que out_of_focus_timeout_secs, se esse fluxo de trabalho for relevante.

Após a reinicialização, algumas compilações registram uma lista de valores de configuração não padrão. Se o seu log de inicialização mostrar isso, procure por per_view.idle_timeout_secs: 1800. Se o comportamento ainda corresponder ao valor antigo, verifique se você editou o arquivo ou o serviço Compose usado pelo processo em execução, se aplicou a alteração e se nenhuma opção de ambiente ou de linha de comando está sobrescrevendo o XML.

Se um documento desaparecer somente após um longo período sem visualizações abertas, revise per_document.idle_timeout_secso problema. Se os usuários estiverem sendo desconectados, verifique a autenticação ou a política de sessão da plataforma host. Essas são camadas diferentes e não são controladas por este componente per_view.idle_timeout_secs. Não reduza o tempo de carregamento do documento apenas para fazer com que uma visualização desapareça mais rapidamente.

Para os nomes de configuração atuais e os valores padrão do repositório upstream, consulte o modelo de configuração do Collabora Online . Para o método do Docker extra_params, consulte a documentação da imagem Docker do CODE . Verifique o comportamento exato em relação à versão e ao pacote que você está usando, pois os valores padrão e a entrega da configuração podem variar.