Integrar Alfresco com ONLYOFFICE

Este guia explica passo a passo como instalar e configurar o plugin onlyoffice-alfresco para permitir edição colaborativa de documentos do Alfresco Share usando os EDITORES ONLINE do ONLYOFFICE. Inclui pré-requisitos, comandos de instalação, verificação, checklist de papéis, solução de problemas comum e recomendações de segurança para produção.

Visão geral

O Alfresco Share usa o repositório ECM do Alfresco para oferecer gestão colaborativa de conteúdo. Integrando o ONLYOFFICE Document Server, usuários podem editar documentos do escritório simultaneamente dentro da interface do Alfresco Share, reduzindo trocas de e-mail e melhorando produtividade.

Requisitos

ONLYOFFICE Document Server (recomendado em produção: instância dedicada ou contêiner Docker)
Java 7 SDK ou superior (Oracle Java 8 recomendado)
Gradle
Acesso de administrador ao servidor Alfresco

Passo a passo de integração

Passo 1. Instalar o ONLYOFFICE Document Server

Siga as instruções oficiais do ONLYOFFICE para instalar o Document Server ou use a imagem Docker oficial para reduzir conflitos de dependência.

Passo 2. Instalar o Gradle

Adicionar o repositório do Gradle:

sudo add-apt-repository ppa:cwchien/gradle

Atualizar pacotes:

sudo apt-get update

Instalar a versão mais recente do Gradle:

sudo apt-get install gradle

Se já tiver o Gradle instalado, remova primeiro:

sudo apt-get remove gradle

Passo 3. Instalar o Oracle Java 8

Para instalar o Oracle Java 8 estável, execute:

sudo add-apt-repository ppa:webupd8team/java   
sudo apt-get update   
sudo apt-get install oracle-java8-installer

Passo 4. Alternativas do Java

Defina o Java ativo para o Oracle Java:

sudo update-alternatives --config java   
sudo update-alternatives --config javac   
sudo update-alternatives --config javaws

Passo 5. Construir dependências necessárias

Clone o plugin Alfresco AMP e publique:

git clone https://github.com/yeyan/alfresco-amp-plugin.git

cd amp-plugin   
gradle publish

Passo 6. Copiar o plugin onlyoffice-alfresco

cd ..  
git clone https://github.com/cetra3/onlyoffice-alfresco.git

Passo 7. Executar gradle amp nos diretórios share e repo

Dentro da árvore do projeto, execute o build/packaging conforme instruções do projeto para gerar os pacotes AMP.

Passo 8. Adicionar onlyoffice.url em alfresco-global.properties

No arquivo alfresco-global.properties do seu Alfresco, adicione a URL do Document Server. Exemplo:

onlyoffice.url=http://seu-document-server:8082/

Ajuste o esquema para https se o Document Server estiver protegido por TLS.

Passo 9. Carregar os pacotes AMP

Copie os AMP gerados de ./build/amp para os diretórios amps/ e amps_share/ da instalação do Alfresco.

Passo 10. Aplicar os AMPs

Execute o script de aplicação de AMPs:

bin/apply_amps.sh

Você verá dois módulos sendo instalados; pressione Enter quando solicitado para concluir.

Após a instalação, a nova ação Edit in Onlyoffice (Editar no OnlyOffice) aparecerá na biblioteca de documentos para arquivos de escritório.

Testes e critérios de aceitação

Ao clicar em Editar no OnlyOffice, o documento abre no editor online sem erros de carregamento.
Várias sessões de usuário podem editar o mesmo documento simultaneamente; as alterações são refletidas em tempo real.
Salvamento funciona sem perda de conteúdo; versões são armazenadas conforme políticas do Alfresco.
Logs do Alfresco e do Document Server não apresentam erros críticos relacionados à integração.

Checklist por papel

Administrador Alfresco:
- Fazer backup completo antes de instalar AMPs.
- Verificar compatibilidade de versão do Alfresco com o plugin.
- Configurar onlyoffice.url no alfresco-global.properties.
DevOps/Infra:
- Garantir Document Server acessível (firewall, portas, proxy reverso).
- Configurar TLS/SSL entre Alfresco e Document Server em produção.
- Monitorar CPU/memória do Document Server.
Usuário final:
- Confirmar que a ação Editar no OnlyOffice aparece na biblioteca.
- Testar edição colaborativa com pelo menos dois usuários.

Mini-metodologia de implantação

Planejar: revisar versões e dependências.
Backup: snapshot/backup do Alfresco e dados.
Ambiente de teste: aplicar AMPs em staging primeiro.
Testes: validar workflows, permissões e salvamentos.
Produção: replicar processo; monitorar depois da ativação.

Solução de problemas comum

Editor não carrega: verifique onlyoffice.url, portas, e CORS; confirme que o Document Server está em execução.
Erro de certificado TLS: importe certificado no servidor Alfresco ou use proxy reverso com certificado válido.
Permissões de arquivo: execute apply_amps.sh com usuário apropriado e verifique permissões em diretórios Alfresco.
Gradle falhando: remova instalações conflitantes e reinstale conforme passos acima.
Versões incompatíveis: consulte o repositório do plugin para notas de compatibilidade.

Importante: consulte os logs de alfresco.log e do Document Server para mensagens detalhadas.

Alternativas e quando optar por elas

Usar imagem Docker do ONLYOFFICE Document Server: recomendado para reduzir problemas de dependência e facilitar upgrades.
Servir Document Server por trás de um proxy reverso (Nginx/Apache) para TLS, load balancing e compressão.
Solução baseada em outro editor colaborativo se houver requisitos de conformidade/data-residency que impeçam uso do Document Server.

Compatibilidade e migração

Verifique compatibilidade entre a versão do Alfresco, Java e Gradle. Em servidores legados, atualizar Java pode ser necessário.
Ao migrar Alfresco, revalide os AMPs após a migração e repita testes de edição colaborativa.

Segurança e privacidade

Transporte: sempre usar HTTPS entre Alfresco e o Document Server em produção.
Autenticação: confirmar que sessões de usuário são validadas antes de abrir documentos no editor.
Logs e auditoria: habilitar auditoria para alterações em documentos sensíveis.
GDPR/Privacidade: certifique-se de que dados pessoais processados através do Document Server respeitam as políticas de retenção e localidade de dados.

Casos de teste recomendados

Usuário A e B editam o mesmo documento simultaneamente; verificar resolução de conflitos e sincronização.
Teste de falha do Document Server durante edição; verificar comportamento do cliente e logs.
Teste de arquivos grandes para avaliar desempenho e uso de banda.

Notas de implantação em produção

Faça um rollout gradual com um grupo piloto antes de disponibilizar para toda a organização.
Monitore SLAs do Document Server (latência de resposta e uso de recursos).

Links úteis

Alfresco official website: https://www.alfresco.com/
ONLYOFFICE official website: http://www.onlyoffice.com/
onlyoffice-alfresco plugin on GitHub: https://github.com/cetra3/onlyoffice-alfresco

Resumo

Integrar o Alfresco com o ONLYOFFICE Document Server requer preparação de ambiente (Java, Gradle), build dos AMPs, configuração de onlyoffice.url e aplicação dos módulos no Alfresco. Testar em staging e garantir TLS e monitoramento são passos essenciais antes de produção.

Notas

Faça backup antes de qualquer alteração em produção.
Preferir Docker para o Document Server quando possível para maior previsibilidade.

Integrar Alfresco com ONLYOFFICE Online Editors