Intégrer Alfresco avec ONLYOFFICE

Ce guide explique comment installer et configurer le plugin onlyoffice-alfresco pour permettre la coédition de documents depuis Alfresco Share avec ONLYOFFICE Online Editors. Il décrit les prérequis, les étapes d’installation, les commandes Gradle/Java à exécuter et propose des checklists, des scénarios de dépannage et des alternatives.

Objectif et variantes d’intention

Intégrer ONLYOFFICE à Alfresco pour la coédition en ligne
Installer le plugin onlyoffice-alfresco
Configurer Alfresco Share pour ouvrir les documents dans ONLYOFFICE
Alternatives : utiliser d’autres connecteurs ou solutions cloud

Exigences

ONLYOFFICE Document Server
Java 7 SDK ou supérieur (recommandé Oracle Java 8 pour compatibilité)
Gradle

Important: assurez-vous que votre Document Server ONLYOFFICE est accessible depuis le serveur Alfresco (pare-feu, NAT, certificats).

Étapes d’installation

Étape 1. Installer ONLYOFFICE Document Server

Suivez la documentation officielle ou utilisez l’image Docker afin d’éviter les erreurs de dépendances.

Étape 2. Installer Gradle

Ajoutez le dépôt Gradle :

sudo add-apt-repository ppa:cwchien/gradle

Mettez à jour les paquets :

sudo apt-get update

Installez Gradle :

sudo apt-get install gradle

Si Gradle est déjà installé, supprimez-le d’abord :

sudo apt-get remove gradle

Étape 3. Installer Oracle Java 8

Pour installer Oracle Java 8 :

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

Étape 4. Changer les alternatives Java

Sélectionnez Oracle Java comme alternative :

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

Étape 5. Construire les dépendances nécessaires

Téléchargez le plugin Alfresco AMP depuis Git et compilez-le :

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

cd amp-plugin
gradle publish

Étape 6. Copier le plugin onlyoffice-alfresco

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

Étape 7. Exécuter gradle amp depuis les répertoires share et repo

Dans les dossiers share et repo du projet, lancez la tâche Gradle appropriée pour générer les AMP.

Étape 8. Ajouter onlyoffice.url au fichier alfresco-global.properties

Ajoutez une entrée pointant vers votre Document Server, par exemple : onlyoffice.url=https://onlyoffice.example.com

Note: ne définissez pas de valeurs sensibles en clair si vous utilisez des environnements partagés.

Étape 9. Charger les packages AMP

Chargez les paquets créés depuis ./build/amp vers les répertoires amps/ et amps_share/ de votre installation Alfresco.

Étape 10. Exécuter le script d’application des AMP

Lancez :

bin/apply_amps.sh

Vous verrez deux modules installés. Appuyez sur Entrée pour compléter l’installation.

Une fois installé, l’action “Edit in Onlyoffice” sera disponible dans la bibliothèque de documents pour les fichiers bureautiques.

Astuce d’intégration rapide

Vérifiez l’accès HTTP(S) entre Alfresco et le Document Server ONLYOFFICE.
Redémarrez Alfresco après application des AMP.
Surveillez les logs Alfresco et ONLYOFFICE pour détecter les erreurs.

Scénarios où l’intégration peut échouer

Incompatibilité de versions Java/Gradle : vérifiez les versions requises.
Problèmes réseau : pare-feu ou règles NAT bloquant l’accès au Document Server.
Permissions Alfresco incorrectes : l’utilisateur Alfresco doit pouvoir lire/écrire les fichiers.
AMP mal construits : rebuild et vérifiez les erreurs Gradle.

Alternatives

Utiliser l’image Docker officielle d’ONLYOFFICE Document Server pour simplifier le déploiement.
Évaluer d’autres connecteurs disponibles dans la communauté Alfresco ou solutions cloud (Google Workspace, Office Online) selon vos contraintes de sécurité et conformité.

Mini-méthodologie d’installation (rapide checklist)

Validez les prérequis réseau et accès.
Installez Java et Gradle sur la machine de build.
Clonez les dépôts et générez les AMP.
Copiez les AMP dans les dossiers amps/ et amps_share/.
Exécutez bin/apply_amps.sh et redémarrez Alfresco.
Configurez onlyoffice.url dans alfresco-global.properties.
Testez l’ouverture et la coédition d’un document.

Checklists par rôle

Administrateur Alfresco:

Vérifier versions Java/Gradle
Appliquer AMP et redémarrer Alfresco
Vérifier logs et permissions

Administrateur réseau:

Ouvrir ports nécessaires (80/443)
Valider certificats SSL/TLS
Tester connectivité entre serveurs

Utilisateur final:

Vérifier que l’option “Edit in Onlyoffice” apparaît
Tester coédition à plusieurs utilisateurs
Signaler erreurs avec captures des logs si possible

Dépannage et runbook d’incident

Vérifier l’accès au Document Server via curl ou navigateur.
Contrôler les logs Alfresco (catalina.out, alfresco.log) pour erreurs AMP.
Contrôler les logs ONLYOFFICE Document Server pour erreurs côté éditeur.
Rebuilder les AMP si des erreurs de packaging sont trouvées.
Si la coédition est lente, tester la latence réseau entre Alfresco et ONLYOFFICE.
En cas d’échec persistant, restaurer une sauvegarde avant l’installation et tester sur un environnement de préproduction.

Important: conservez toujours une sauvegarde avant d’appliquer des AMP en production.

Critères d’acceptation

L’action “Edit in Onlyoffice” est visible dans Alfresco Share pour les fichiers pris en charge.
Les documents s’ouvrent dans ONLYOFFICE Online Editors sans erreur.
Deux utilisateurs ou plus peuvent modifier le même document en temps réel.
Aucun message d’erreur critique dans les logs pendant l’utilisation.

Glossaire (une ligne)

AMP: Alfresco Module Package, paquet étendant Alfresco.
ONLYOFFICE Document Server: moteur d’édition en ligne pour coédition.
Alfresco Share: interface collaborative d’Alfresco ECM.

Liens utiles

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

Aperçu social et annonce courte

OG Title: Intégration Alfresco + ONLYOFFICE

OG Description: Guide pas à pas pour connecter Alfresco Share à ONLYOFFICE et activer la coédition.

Annonce (100–200 mots): Ce guide décrit la procédure pour intégrer ONLYOFFICE Online Editors avec Alfresco Share via le plugin onlyoffice-alfresco. Il couvre les prérequis (Java, Gradle, ONLYOFFICE Document Server), la compilation des AMP, l’ajout de onlyoffice.url dans alfresco-global.properties, et le déploiement des packages. Des checklists et un runbook de dépannage facilitent l’installation en production. Idéal pour équipes souhaitant offrir la coédition en temps réel directement depuis Alfresco.

Résumé

Validez prérequis technique et accès réseau.
Utilisez Gradle pour construire les AMP.
Copiez et appliquez les AMP dans Alfresco, puis redémarrez.
Testez la coédition et surveillez les logs.

Notes: adaptez les chemins et versions à votre environnement. Si votre organisation exige des restrictions réseau, privilégiez une installation Docker ou un environnement isolé.

Intégrer Alfresco avec ONLYOFFICE Online Editors