Integration. Erste Schritte. Moodle

Hilfe-Center

Integration

So integrieren Sie ONLYOFFICE mit Nextcloud

Über die ONLYOFFICE- und Moodle-Integration

ONLYOFFICE bietet einen offiziellen Konnektor, um ONLYOFFICE Docs mit Moodle zu integrieren und Office-Dokumente zu bearbeiten, die an die Kursseiten angehängt sind. Sie können den ONLYOFFICE-Konnektor von der Moodle Plugin-Bibliothek oder von der GitHub-Seite herunterladen.

Haupteigenschaften

Bearbeiten und Anzeigen von Textdokumenten, Tabellenkalkulationen, Präsentationen und Formularen.
Um mehr über Formulare zu erfahren, lesen Sie bitte die entsprechenden Artikel zum Erstellen und Ausfüllen von Formularen.
Gemeinsame Bearbeitung von Dokumenten in Echtzeit: zwei Bearbeitungs-Modi (Schnell und Formal). Verfolgen Sie Änderungen und verwenden Sie Kommentare und den integrierten Chat.
JWT-Unterstützung, um Ihren Datenverkehr zu sichern, damit niemand mit Ausnahme der Benutzer mit den entsprechenden Rechten auf Ihre Dokumente zugreifen können.

Unterstützte Formate

Anzeigen und Bearbeiten: DOCX, XLSX, PPTX, DOCXF
Nur Anzeigen: PDF, TXT, CSV
Ausfüllen von Formularen: OFORM
Konvertieren in Office Open XML-Formate: ODT, ODS, ODP, DOC, XLS, PPT, PPS, EPUB, RTF, HTML, HTM

Was gibt es Neues in Versionen 2.2.0 und 3.0.0

Hinzugefügt

Schutzoption für Editor
Fähigkeit hinzufügen, Editor im Vollbildmodus zu öffnen
Erwähnungen in Kommentaren im Editor hinzufügen
"Speichern als" im Editor
Fähigkeit hinzufügen, Aktivität mit leerer Datei zu erstellen
Favicon auf Editorseite hinzufügen
Anpassung der Editor-Oberfläche
de, es, fr, it, ja, ru, zh_cn Übersetzungen
Unterstützung für ONLYOFFICE-Formulare hinzufügen

Geändert

Sprache der Editoroberfläche einstellen
Korrekturen beim Erstellen von Backups und Wiederherstellungen
Neugestaltung auf Moodle 4

Das vollständige Änderungsprotokoll ist hier verfügbar.

Verbinden von ONLYOFFICE Docs mit Moodle

Anforderungen

ONLYOFFICE Docs (Document Server) 4.2.7 oder höher
Sie benötigen eine Instanz von ONLYOFFICE Docs, die sowohl von Moodle als auch von beliebigen End-Clients auflösbar und verbindbar ist. Die Instanz muss direkt an Moodle POSTen können.

Weitere Informationen finden Sie auf der offiziellen Dokumentationsseite über die Installation von ONLYOFFICE Docs.
Moodle v3.9.10 oder höher
ONLYOFFICE-Konnektor v3.0.0 für Moodle

Installieren des ONLYOFFICE-Konnektors für Moodle

Moodle Plugin-Bibliothek verwenden

Melden Sie sich als Administrator bei Ihrer Moodle-Instanz an und öffnen Sie Site administration > Plugins > Install plugins.
Wenn Sie diesen Speicherort nicht finden können, ist die Plugin-Installation auf Ihrer Webseite deaktiviert.
Klicken Sie auf die Schaltfläche Install plugins from Moodle plugins directory.
Wählen Sie Ihre aktuelle Moodle-Version aus.
Suchen Sie nach dem Plugin ONLYOFFICE document.
Klicken Sie auf die Schaltfläche Install, dann klicken Sie auf Continue.
Bestätigen Sie die Installationsanfrage.
Überprüfen Sie den Plugin-Validierungsbericht.
Es ist äußerst wichtig, dass Sie Ihre Moodle-Version richtig auswählen. Wenn Sie versehentlich die falsche Version des Plugins für Ihren Moodle-Server herunterladen und installieren, kann dies zu ernsthaften Problemen führen, bis hin zum Einfrieren der Moodle-Seite.

GitHub .ZIP-Archiv verwenden

Laden Sie den Konnektor von der GitHub-Seite herunter.
Melden Sie sich als Administrator bei Ihrer Moodle-Instanz an, gehen Sie zum Abschnitt Site administration, wechseln Sie zur Registerkarte Plugins und klicken Sie auf den Link Install plugins.
Laden Sie die Datei moodle-mod_onlyofficeeditor-x.x.x.zip über die Dateiauswahl hoch oder ziehen Sie sie per Drag-and-Drop in das entsprechende Feld und klicken Sie auf die Schaltfläche Install plugin from the ZIP file.
Überprüfen Sie den Plugin-Validierungsbericht und klicken Sie auf Continue.
Wenn Ihr Zielverzeichnis nicht beschreibbar ist, erhalten Sie eine Warnmeldung, z.B. [Error] Write access check [/var/www/html/moodle/mod]. In diesem Fall können Sie es mit dem folgenden Befehl vorübergehend beschreibbar machen:
```
sudo chmod -R 777 /var/www/html/moodle
```
Wiederholen Sie danach Schritt 3.

Nach der Installation des Plugins müssen Sie die Berechtigungen zurücksetzen, damit das Verzeichnis nicht mehr beschreibbar ist. Verwenden Sie den folgenden Befehl:
```
sudo chmod -R 0755 /var/www/html/moodle
```
Klicken Sie auf der Seite Current release information -> Server checks auf Continue.
Klicken Sie auf der Seite Plugins check auf Upgrade Moodle database now.
Klicken Sie auf der Seite Upgrading to new version auf Continue.

Konfigurieren des ONLYOFFICE-Konnektors für Moodle

Sobald das Plugin installiert ist, wird die Seite mit den Plugin-Einstellungen geöffnet. Alternativ finden Sie das ONLYOFFICE document auf der Seite Plugins overview und klicken auf Settings. Auf der Seite Settings können Sie die folgenden Parameter konfigurieren:

Geben Sie in das Feld Document Editing Service address die Adresse ein, die für den Zugriff auf das Document Editing Service von Moodle verwendet wird. Dieses Feld ist obligatorisch.
Geben Sie optional das zum Signieren der Daten verwendete Geheimnis im Feld Document Server Secret an. Der geheime Schlüssel wird verwendet, um das JSON-Web-Token bei der Anforderung an Document Server zu validieren. Weitere Informationen finden Sie in der API-Dokumentation zur Konfiguration von JWT auf dem ONLYOFFICE Docs-Seite.
Ab ONLYOFFICE Docs v7.2 ist JWT standardmäßig aktiviert und der geheime Schlüssel wird automatisch generiert. Sie müssen es auch auf der Moodle-Seite aktivieren: Suchen Sie Ihren geheimen Schlüssel in der ONLYOFFICE Docs-Konfigurationsdatei und geben Sie dann denselben geheimen Schlüssel in den Konnektor-Einstellungen an. Weitere Einzelheiten finden Sie im Abschnitt Aktivieren von JWT für die ONLYOFFICE- und Moodle-Integration in diesem Artikel.
Enable Force Save - wenn diese Option deaktiviert ist, werden Ihre Änderungen automatisch im Editor-Cache gespeichert. Wenn diese Option aktiviert ist, werden alle Änderungen an einem Dokument direkt an den Speicher gesendet, wenn Sie auf die Schaltfläche Save klicken.
Geben Sie optional die Anpassungseinstellungen des Editors an, indem Sie die erforderlichen Kontrollkästchen aktivieren:
- Display Chat menu button - diese Option wird verwendet, um die Chat-Menüschaltfläche anzuzeigen oder auszublenden.
- Display Help menu button - diese Option wird verwendet, um die Hilfemenü-Schaltfläche anzuzeigen oder auszublenden.
- Display the header more compact - diese Option wird verwendet, um die zusätzlichen Aktionsschaltflächen entweder im oberen Teil der Kopfzeile des Editorfensters neben dem Logo oder in der Symbolleiste anzuzeigen.
- Display Feedback & Support menu button - diese Option wird verwendet, um die Menüschaltfläche „Feedback & Support“ anzuzeigen oder auszublenden.
- Display monochrome toolbar header - diese Option wird verwendet, um die Editor-Symbolleiste in Monochrom anzuzeigen.

Wenn Sie bereits sind, klicken Sie auf Save changes.

Aktivieren von JWT für die ONLYOFFICE- und Moodle-Integration

Um Dokumente vor unbefugtem Zugriff zu schützen, verwenden ONLYOFFICE-Editoren das JSON Web Token (JWT). Das Token wird in der Konfiguration hinzugefügt, wenn der Dokumenteneditor initialisiert wird und während des Austauschs von Befehlen zwischen internen ONLYOFFICE Docs-Diensten. Der geheime Schlüssel wird verwendet, um das JSON-Web-Token zu signieren und das Token auf 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 dann denselben geheimen Schlüssel in den Konnektor-Einstellungen angeben.

Schritt 1: Ihren geheimen Schlüssel in der Konfigurationsdatei von ONLYOFFICE Docs finden

Öffnen Sie die Datei local.json mit einem beliebigen verfügbaren Texteditor.

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

Die local.json-Datei 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"
        }
      }
    }
  }
}

Der Wert true wird in drei Abschnitten angegeben. Dies bedeutet, dass die Token-Validierung aktiviert ist.
- services.CoAuthoring.token.enable.browser
- services.CoAuthoring.token.enable.request.inbox
- services.CoAuthoring.token.enable.request.outbox
Der automatisch generierte geheime Schlüssel wird in drei Abschnitten angegeben. Sie können den standardmäßigen geheimen Wert durch Ihren eigenen geheimen Schlüssel ersetzen. Der geheime Schlüssel muss in drei Abschnitten gleich sein.
- services.CoAuthoring.secret.inbox.string
- services.CoAuthoring.secret.outbox.string
- services.CoAuthoring.secret.session.string
Wenn Sie Änderungen vornehmen, speichern Sie diese Änderungen und starten Sie die Dienste neu, damit die Konfigurationsänderungen aktualisiert werden.
```
supervisorctl restart all
```

Schritt 2: Denselben geheimen Schlüssel in den Konnektor-Einstellungen angeben

Geben Sie in den Konnektor-Einstellungen dasselbe Geheimnis im Feld Secret Key an und speichern Sie die Einstellungen.

Verwendung von ONLYOFFICE Docs in Moodle

Hinzufügen von ONLYOFFICE-Aktivitäten

Um eine neue ONLYOFFICE-Aktivität zu erstellen:

Öffnen Sie den Bereich My Courses und wechseln Sie zum gewünschten Kurs.
Aktivieren Sie Edit Mode mit dem Umschalter oben rechts.
Klicken Sie auf Add an activity or resource.
Wählen Sie im Pop-Up-Fenster die Aktivität ONLYOFFICE document aus.
Geben Sie den Aktivitätsnamen ein, laden Sie das erforderliche Dokument hoch oder ziehen Sie es per Drag-and-Drop von Ihrem PC ab und klicken Sie auf die Schaltfläche Save and display.

Die Aktivität kann eine leere .docx-, .xlsx-, .pptx- oder .docxf-Datei sein.

Das Dokument wird im ONLYOFFICE Docs-Editor geöffnet.

Dateien anzeigen und bearbeiten

ONLYOFFICE-Aktivitäten werden mit dem Symbol gekennzeichnet auf Ihren Kursseiten. Um ein Dokument im ONLYOFFICE Docs-Editor zu öffnen, klicken Sie einfach auf seinen Titel.

Um den Editor im Vollbildmodus zu öffnen, klicken Sie oben rechts über dem Editorfenster auf die Schaltfläche Open full screen.

Dateien mit einem Passwort schützen

ONLYOFFICE-Dateien können mit einem Passwort geschützt werden, um unbefugten Zugriff zu verhindern:

Gehen Sie zur Registerkarte Datei in der oberen Symbolleiste.
Wählen Sie die Option Schützen.
Klicken Sie auf die Schaltfläche Kennwort hinzufügen.
Legen Sie im Feld Kennwort ein Passwort fest und wiederholen Sie es unten im Feld Kennwort wiederholen. Klicken Sie dann auf OK.
Das Passwort kann nicht wiederhergestellt werden, wenn Sie es verlieren oder vergessen. Bitte bewahren Sie es an einem sicheren Ort auf.

Um das Kennwort zu ändern,

Gehen Sie zur Registerkarte Datei in der oberen Symbolleiste.
Wählen Sie die Option Schützen.
Klicken Sie auf die Schaltfläche Kennwort ändern.
Legen Sie im Feld Kennwort ein Passwort fest und wiederholen Sie es unten im Feld Kennwort wiederholen. Klicken Sie dann auf OK.

Um das Kennwort zu löschen,

Gehen Sie zur Registerkarte Datei in der oberen Symbolleiste.
Wählen Sie die Option Schützen.
Klicken Sie auf die Schaltfläche Kennwort löschen.

Um die Schutzoption zu deaktivieren,

Öffnen Sie die Aktivitätsbearbeitungsseite.
Öffnen Sie den Abschnitt Document permissions.
Aktivieren Sie das Kontrollkästchen Hide Protection tab box.

Berechtigungen verwalten

Administratoren/Lehrer können wählen, ob Dokumente aus dem ONLYOFFICE-Editor heruntergeladen oder gedruckt werden können. Dies kann im Abschnitt Document permissions erfolgen.

Um die Dokumentberechtigung in schreibgeschützt zu ändern:

Öffnen Sie das benötigte ONLYOFFICE-Dokument.
Öffnen Sie More -> Permissions.
Suchen Sie den Eintrag Edit ONLYOFFICE document activity/View ONLYOFFICE document activity.
Fügen Sie die erforderlichen Rollen im Abschnitt Prohibited hinzu oder entfernen Sie die Rollen aus dem Abschnitt Roles with permission.

Um zu erfahren, wie Sie das Dokument direkt im Editor als Favorit markieren, befolgen Sie bitte die Anweisungen in diesem Artikel.

Herunterladen Beste Editoren auf Ihrer Webseite Lassen Sie Ihre Seite-Benutzer alle Arten von Text-, Tabellenkalkulations- und Präsentationsdateien
öffnen und gemeinsam bearbeiten

Wer sich dafür interessiert hat,
hat auch das Folgende gelesen:

Schließen

Artikel zum Thema:

Changelog