Alfresco mit ONLYOFFICE integrieren

Diese Anleitung beschreibt Schritt für Schritt, wie das onlyoffice-alfresco Plugin installiert wird, damit Anwender Office-Dokumente in Alfresco Share gemeinsam in den ONLYOFFICE Online Editors bearbeiten können. Die Anleitung umfasst Voraussetzungen, Installation der Abhängigkeiten, Build- und Deploy-Schritte sowie Konfigurations- und Prüfhinweise.

Einführung

Alfresco Share basiert auf dem Alfresco-ECM-Repository und bietet fertige Funktionen für kollaboratives Content-Management. Mit der ONLYOFFICE-Integration können Teams Dokumente direkt aus der Dokumentenbibliothek gemeinsam bearbeiten. Diese Anleitung konzentriert sich auf eine Debian/Ubuntu-ähnliche Umgebung und beschreibt die notwendigen Schritte zur Integration.

Voraussetzungen

ONLYOFFICE Document Server installiert und erreichbar
Java SDK 7 oder neuer (Oracle Java 8 empfohlen)
Gradle
Administrativer Zugriff auf den Alfresco-Server und Dateisystem

Wichtig: Stellen Sie sicher, dass die Komponenten voneinander aus Netzwerk- und Firewall-Sicht erreichbar sind und dass Sie Sicherungskopien Ihrer Alfresco-Installation vor Änderungen anfertigen.

Schritt-für-Schritt Anleitung

Schritt 1. ONLYOFFICE Document Server installieren

Installieren Sie ONLYOFFICE Document Server nach den offiziellen Anweisungen oder verwenden Sie das Docker-Image, um Abhängigkeitsprobleme zu vermeiden. Dokumentation und Images finden Sie auf der ONLYOFFICE-Website.

Schritt 2. Gradle installieren

Fügen Sie das Gradle-Repository hinzu:

sudo add-apt-repository ppa:cwchien/gradle

Aktualisieren Sie die Paketliste:

sudo apt-get update

Installieren Sie die aktuelle Gradle-Version:

sudo apt-get install gradle

Falls bereits eine Gradle-Installation vorhanden ist, entfernen Sie diese zuerst:

sudo apt-get remove gradle

Hinweis: Alternativ können Sie Gradle über die offizielle Gradle-Website manuell installieren, wenn Ihre Distribution andere Paketquellen verwendet.

Schritt 3. Oracle Java 8 installieren

Installieren Sie Oracle Java 8 mit den folgenden Befehlen:

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

Stellen Sie sicher, dass die Installation erfolgreich war, indem Sie “java -version” ausführen.

Schritt 4. Java-Alternativen anpassen

Wechseln Sie die Java-Alternativen auf Oracle Java:

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

Wählen Sie in jeder Abfrage die passende Oracle-Installation aus.

Schritt 5. Benötigte Abhängigkeiten bauen

Laden Sie das Alfresco-Plugin aus dem Git-Repository und bauen Sie es:

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

cd amp-plugin
gradle publish

Dieser Schritt erzeugt AMP-Pakete, die später in Alfresco eingespielt werden.

Schritt 6. onlyoffice-alfresco Plugin kopieren

Klonen Sie das onlyoffice-alfresco Repository:

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

Schritt 7. Gradle AMP im share- und repo-Verzeichnis ausführen

Führen Sie in den jeweiligen Verzeichnissen des Plugins die Gradle-Befehle aus, um die AMP-Verpackungen zu erzeugen. Üblicherweise befinden sich die Build-Artefakte unter ./build/amp.

Schritt 8. onlyoffice.url in alfresco-global.properties hinzufügen

Öffnen Sie die Datei alfresco-global.properties und fügen Sie die Adresse des ONLYOFFICE Document Servers hinzu. Beispiel:

onlyoffice.url=http://onlyoffice.example.com

Verwenden Sie https, wenn Ihr Document Server über TLS/SSL erreichbar ist. Achten Sie auf korrekte Hostnamen und Ports.

Schritt 9. AMP-Pakete kopieren

Laden Sie die erstellten Pakete aus ./build/amp in die Verzeichnisse amps/ und amps_share/ Ihrer Alfresco-Installation:

Kopieren Sie die AMP-Dateien nach /amps/
Kopieren Sie die Share-AMP-Dateien nach /amps_share/

Schritt 10. AMP-Pakete anwenden

Führen Sie das apply_amps.sh Script aus und folgen Sie den Anweisungen. Sie werden zwei Module sehen; drücken Sie Enter, um die Installation abzuschließen. Nach erfolgreicher Ausführung werden die AMPs eingespielt und Tomcat neu aufgebaut.

Nach der Installation sollte in der Dokumentenbibliothek die neue Aktion “Edit in Onlyoffice” für Office-Dokumente angezeigt werden.

Konfigurationshinweise

URL-Format: Verwenden Sie in onlyoffice.url das vollständige Schema inklusive http(s) und Host (z. B. https://onlyoffice.example.com). Wenn der Document Server auf einem nicht standardmäßigen Port läuft, fügen Sie diesen an.
SSL/TLS: Bei https stellen Sie sicher, dass Zertifikate auf beiden Seiten (Alfresco und ONLYOFFICE) vertrauenswürdig sind oder fügen Sie Ausnahmen hinzu.
Firewall: Öffnen Sie die relevanten Ports zwischen Alfresco und dem Document Server.
Benutzerrechte: Der Alfresco-Prozess benötigt Leserechte auf die eingespielten AMP-Dateien und Schreibrechte, falls temporäre Dateien erstellt werden.

Prüfungen und Akzeptanzkriterien

Der ONLYOFFICE Document Server ist über die in onlyoffice.url eingetragene Adresse erreichbar.
Die AMP-Pakete wurden erfolgreich angewendet ohne Fehler in der Ausgabe von apply_amps.sh.
In Alfresco Share erscheint die Aktion “Edit in Onlyoffice” in der Dokumentenbibliothek für Office-Dateien.
Zwei Benutzer können dasselbe Dokument gleichzeitig in ONLYOFFICE öffnen und sehen Bearbeitungen in Echtzeit.

Häufige Probleme und Fehlerbehebung

Dokument lässt sich nicht öffnen: Prüfen Sie die Browser-Konsole und die Logs von Alfresco und ONLYOFFICE. Prüfen Sie die onlyoffice.url auf Tippfehler.
502/504 oder Verbindungstimeout: Überprüfen Sie Netzwerkverbindung, Proxy- und Firewall-Einstellungen zwischen Alfresco und Document Server.
CORS- oder Mixed-Content-Fehler: Stellen Sie sicher, dass Protokolle (http/https) übereinstimmen oder konfigurieren Sie CORS passend.
Gradle-Build-Fehler: Kontrollieren Sie Java-Version und Gradle-Version. Entfernen Sie ggf. ältere Gradle-Pakete und installieren Sie die empfohlene Version.
Rechteprobleme beim Anwenden der AMPs: Prüfen Sie Dateisystemberechtigungen und führen Sie apply_amps.sh mit einem Benutzer aus, der Schreibrechte auf das Alfresco-Verzeichnis hat.

Wenn Logs nicht aussagekräftig sind, erhöhen Sie vorübergehend die Log-Level in Alfresco und ONLYOFFICE, führen Sie den reproduzierbaren Test erneut aus und prüfen die neuen Einträge.

Rollen-Checkliste vor dem Rollout

Administrator
- Backup der Alfresco-Installation anfertigen
- ONLYOFFICE Document Server erreichbar konfigurieren
- onlyoffice.url setzen und testen
Entwickler / Integrator
- AMP-Pakete bauen und in Testumgebung anwenden
- Integrations- und Lasttests durchführen
Endbenutzer
- Testdokumente anlegen
- Gemeinsames Bearbeiten testen und Rückmeldung geben

Testablauf (Mini-Methodik)

Prüfumgebung herstellen (Staging).
ONLYOFFICE und Alfresco-Server starten.
In Alfresco Share ein Testdokument hochladen.
Als Benutzer A Dokument in ONLYOFFICE öffnen.
Als Benutzer B dasselbe Dokument öffnen und Änderungen vornehmen.
Prüfen, ob Änderungen in Echtzeit sichtbar sind.
Logs auf Fehler überprüfen.

Kurzes Glossar

Alfresco: Enterprise Content Management Plattform.
ONLYOFFICE Document Server: Webbasierte Editier-Engine für Office-Dateien.
Gradle: Build-Tool zur Erzeugung von AMP/Artefakten.
Java SDK: Laufzeitumgebung für Java-Applikationen.
AMP: Alfresco Module Package, Erweiterungsformat für Alfresco.

Ablaufdiagramm der Integration

flowchart LR
  A[Install Document Server] --> B[Install Java und Gradle]
  B --> C[Build Alfresco AMP]
  C --> D[Add onlyoffice.url to alfresco-global.properties]
  D --> E[Copy AMPs to amps und amps_share]
  E --> F[Run apply_amps.sh]
  F --> G[Testen: Edit in Onlyoffice]

FAQ

Q: Muss ONLYOFFICE auf demselben Server wie Alfresco laufen?

A: Nein. ONLYOFFICE kann separat betrieben werden. Wichtiger ist, dass Alfresco den Document Server per Netzwerk erreichen kann.

Q: Kann ich https verwenden?

A: Ja, https wird empfohlen. Achten Sie auf gültige Zertifikate und die korrekte Konfiguration von onlyoffice.url.

Q: Welche Alfresco-Versionen werden unterstützt?

A: Dieses Plugin ist für Alfresco Share entwickelt. Prüfen Sie die Kompatibilität des GitHub-Repositories mit Ihrer Alfresco-Version und testen Sie in einer Staging-Umgebung.

Zusammenfassung

Die Integration verbindet Alfresco Share mit ONLYOFFICE und ermöglicht kollaboratives Bearbeiten von Office-Dokumenten. Folgen Sie den Schritten zur Installation von Java und Gradle, bauen Sie die AMP-Pakete, fügen Sie onlyoffice.url hinzu und spielen Sie die AMPs ein. Testen Sie die Funktionalität in einer sicheren Staging-Umgebung, bevor Sie in Produktion gehen.

Wichtige Hinweise

Erstellen Sie Backups vor Änderungen.
Testen Sie SSL, Firewall und Netzwerkrouten.
Überprüfen Sie Logs bei Problemen.

Alfresco mit ONLYOFFICE Online Editors integrieren