Zum Hauptinhalt springen

Alfresco Content App

Über die ONLYOFFICE- und Alfresco-Content-App-Integration​

ONLYOFFICE bietet eine offizielle Integration, die die Dokumentbearbeitung und Zusammenarbeit direkt in die Alfresco Content App (ACA) bringt — die moderne Angular-basierte Oberfläche für Alfresco Content Services. Sie können das Integrationspaket über die npm-Registry oder die ONLYOFFICE-GitHub-Seite herunterladen.

hinweis

Diese Integration ist speziell für die Alfresco Content App gedacht. Wenn Sie Alfresco Share verwenden, lesen Sie stattdessen den Artikel ONLYOFFICE-Konnektor für Alfresco Share.

Haupteigenschaften​

  • Erstellen, Bearbeiten und Anzeigen von Textdokumenten, Tabellenkalkulationen und Präsentationen.
  • Erstellen und Ausfüllen von ausfüllbaren PDF-Formularen.
  • Gemeinsame Bearbeitung von Dokumenten in Echtzeit: zwei Modi für die gemeinsame Bearbeitung (Schnell und Formal), der Modus Änderungen nachverfolgen, Kommentare und der integrierte Chat.
  • Verfolgung des Versionsverlaufs von Dokumenten direkt in der Editor-Oberfläche.
  • Dateikonvertierung in OOXML-Formate und Export in verschiedene Formate.
  • Verwaltung von Dokumentberechtigungen in der Bearbeitungsoberfläche.
  • Erweiterte Editor-Aktionen: Einfügen von Bildern aus Alfresco, Anhängen von Dateien für den Serienbrief, Auswählen von Dokumenten zum Vergleich, Verwenden von Plugins, Einfügen von Daten aus externen Links, Navigieren zum Ordner der aktuellen Datei und Erstellen neuer Dokumente direkt im Editor.
  • JWT-Unterstützung zur Absicherung Ihres Datenverkehrs, damit niemand außer Benutzern mit entsprechenden Rechten auf Ihre Dokumente zugreifen kann.

Unterstützte Formate​

  • Zum Bearbeiten: DOCX, XLSX, PPTX
  • Zum Anzeigen: DOCX, XLSX, PPTX, PDF und andere Office-Formate
  • Zum Erstellen: DOCX, XLSX, PPTX, PDF-Formulare
  • Zum Konvertieren: Office-Formate in OOXML
  • Zum Exportieren: verschiedene Formate je nach Backend-Konfiguration
hinweis

Die genaue Liste der verfügbaren Formate zum Bearbeiten, Anzeigen, Konvertieren und Exportieren kann je nach installierter Version und Backend-Konfiguration variieren.

Neuigkeiten in Version 1.0.0​

Erste Version der ONLYOFFICE-Integration für die Alfresco Content App.

Das vollständige Änderungsprotokoll finden Sie hier.

ONLYOFFICE Docs mit der Alfresco Content App verbinden​

Anforderungen​

  • Alfresco Content Services — das Alfresco-Repository-Backend.

  • Alfresco Content App (ACA) — die Angular-Host-Anwendung.

  • ONLYOFFICE Docs (Server- oder Cloud-Version), die sowohl von der ACA als auch von allen Endclients aufgelöst und erreicht werden kann.

    Weitere Informationen zur Installation von ONLYOFFICE Docs finden Sie auf der offiziellen Dokumentationsseite.

  • ONLYOFFICE-Modulpaket für Alfresco Version 8.3.0 oder höher.

  • ONLYOFFICE-Integration für die Alfresco Content App v1.0.0 oder höher.

ONLYOFFICE-Integration für die Alfresco Content App installieren​

  1. Installieren Sie das Erweiterungspaket:

    npm install @onlyoffice/alfresco-extension

  2. Registrieren Sie die Erweiterung in Ihrem ACA-Projekt.

  3. Starten Sie die Anwendung:

    npm run start

Ausführliche Installations- und Konfigurationsanweisungen finden Sie in der Projektdokumentation.

JWT für die ONLYOFFICE- und Alfresco-Content-App-Integration aktivieren​

Um Dokumente vor unbefugtem Zugriff zu schützen, verwenden die ONLYOFFICE-Editoren das JSON Web Token (JWT). Das Token wird bei der Initialisierung des Dokumenteneditors und beim Austausch von Befehlen zwischen den internen ONLYOFFICE Docs-Diensten zur Konfiguration hinzugefügt. Der geheime Schlüssel wird verwendet, um das JSON Web Token zu signieren und das Token bei der Anfrage an ONLYOFFICE Docs zu validieren.

Ab ONLYOFFICE Docs v7.2 ist JWT standardmäßig aktiviert und der geheime Schlüssel wird automatisch generiert. Sie müssen Ihren geheimen Schlüssel in der ONLYOFFICE Docs-Konfigurationsdatei finden und anschließend denselben geheimen Schlüssel in den Integrationseinstellungen angeben.

Schritt 1: Suchen Sie Ihren geheimen Schlüssel in der ONLYOFFICE Docs-Konfigurationsdatei

  1. Öffnen Sie die Datei local.json mit einem beliebigen Texteditor.

    • Für Linux — /etc/onlyoffice/documentserver/local.json
    • Für Windows — %ProgramFiles%\ONLYOFFICE\DocumentServer\config\local.json
    • Für Docker — rufen Sie den ONLYOFFICE Docs-Container mit dem Befehl docker exec -it <containerID> bash auf und öffnen Sie /etc/onlyoffice/documentserver/local.json

    Die Datei local.json sollte wie folgt aussehen:

    {
      "services": {
        "CoAuthoring": {
          "token": {
            "enable": {
              "request": {
                "inbox": true,
                "outbox": true
              },
              "browser": true
            }
          },
          "secret": {
            "inbox": {
              "string": "yoursecret"
            },
            "outbox": {
              "string": "yoursecret"
            },
            "session": {
              "string": "yoursecret"
            }
          }
        }
      }
    }

  2. Der Wert true ist in drei Abschnitten angegeben, was bedeutet, dass die Token-Validierung aktiviert ist:

    • services.CoAuthoring.token.enable.browser
    • services.CoAuthoring.token.enable.request.inbox
    • services.CoAuthoring.token.enable.request.outbox

  3. Der automatisch generierte geheime Schlüssel ist in drei Abschnitten angegeben. Sie können den standardmäßigen geheimen Wert durch Ihren eigenen ersetzen. Der geheime Schlüssel muss in allen drei Abschnitten identisch sein:

    • services.CoAuthoring.secret.inbox.string
    • services.CoAuthoring.secret.outbox.string
    • services.CoAuthoring.secret.session.string

  4. Wenn Sie Änderungen vornehmen, speichern Sie diese und starten Sie die Dienste neu, damit die Konfigurationsänderungen wirksam werden:

    supervisorctl restart all

Schritt 2: Geben Sie denselben geheimen Schlüssel in den Integrationseinstellungen an

Geben Sie in den Integrationseinstellungen denselben geheimen Schlüssel im Feld Geheimer Schlüssel an und speichern Sie die Einstellungen.

Erste Schritte mit ONLYOFFICE Docs in der Alfresco Content App​

Nach der Installation stehen neue ONLYOFFICE-Aktionen direkt in der Oberfläche der Alfresco Content App zur Verfügung.

So bearbeiten Sie ein Dokument:

  1. Klicken Sie in der ACA-Oberfläche mit der rechten Maustaste auf eine unterstützte Datei.
  2. Wählen Sie In ONLYOFFICE bearbeiten, um die Datei im Editor zu öffnen.

So zeigen Sie ein Dokument an:

  1. Klicken Sie mit der rechten Maustaste auf die Datei.
  2. Wählen Sie In ONLYOFFICE anzeigen, um eine schreibgeschützte Vorschau zu öffnen, ohne die Datei herunterzuladen.

So erstellen Sie eine neue Datei:

  1. Verwenden Sie die Option In ONLYOFFICE erstellen in der ACA-Oberfläche.
  2. Wählen Sie den Typ der Datei, die Sie erstellen möchten: Dokument, Tabelle, Präsentation oder PDF-Formular.
  3. Die neue Datei wird sofort zur Bearbeitung geöffnet.

So konvertieren Sie eine Datei in das OOXML-Format:

  1. Wählen Sie die Datei in der ACA aus.
  2. Klicken Sie auf In ONLYOFFICE konvertieren.

So exportieren Sie eine Datei in ein anderes Format:

  1. Wählen Sie die Datei in der ACA aus.
  2. Verwenden Sie Herunterladen als und wählen Sie das gewünschte Format, ohne die Alfresco Content App zu verlassen.

Weitere Informationen zu Formularen finden Sie in den entsprechenden Artikeln zum Erstellen und Ausfüllen von Formularen.