Mit Integration | Nextcloud arbeiten

Mit Integration | Nextcloud verbinden Sie eigene Ordner in agorum core mit Ordnern in Ihrer Nextcloud. Synchronisiert wird automatisch nach den Zeitplänen Ihres Administrators; zusätzlich können Sie eine Synchronisierung von Hand anstoßen.

Voraussetzungen für die Nextcloud-Synchronisierung

Um mit Integration | Nextcloud zu arbeiten, brauchen Sie:

• die Berechtigung für die Nextcloud-Synchronisierung, siehe Integration | Nextcloud berechtigen
• ein Konto in der Nextcloud; mit Zwei-Faktor-Anmeldung ein App-Passwort aus den Sicherheitseinstellungen der Nextcloud
• einen gestarteten Synchronisierungs-Task; ohne ihn wird nichts synchronisiert, auch nicht von Hand

Die Synchronisierung läuft immer mit Ihren Rechten in agorum core und in Nextcloud.

Nextcloud-Synchronisierung einrichten

Eine Konfiguration von Integration | Nextcloud enthält Ihre Anmeldedaten für Nextcloud und bis zu 10 Regeln. Jede Regel verbindet einen Ordner in agorum core mit einem Ordner in Nextcloud.

Einrichtung aufrufen

Ort	Aktion	Wirkung
Hauptmenü	Nextcloud-Synchronisierung einrichten	Öffnet die Auswahl Ihrer Konfigurationen.
Kontextmenü eines Ordners	Nextcloud-Synchronisierung einrichten	Öffnet die Konfiguration mit einer Regel genau auf diesem Ordner. Gibt es keine, öffnet sich eine neue Konfiguration mit dem Ordner als erster Regel.
Kontextmenü eines Ordners	Mit Nextcloud synchronisieren	Reiht für jede Konfiguration mit einer Regel genau auf diesem Ordner eine Synchronisierung ein und öffnet das Protokoll.

Im Fenster Nextcloud-Synchronisierung einrichten wählen Sie im Feld Konfiguration eine vorhandene Konfiguration und klicken auf Bearbeiten. Mit + rechts über dem Feld legen Sie eine neue Konfiguration an. Neben dem Feld suchen Sie mit der Lupe in Ihren Konfigurationen oder klonen die gewählte Konfiguration samt Anmeldedaten und Regeln. Eine geklonte Konfiguration braucht einen neuen Namen; solange ihre Regeln dieselben Ordner synchronisieren wie die Vorlage, lässt sie sich nicht aktiv speichern, siehe Doppelte und überlappende Regeln.

Konfiguration anlegen

Gehen Sie wie folgt vor, um eine Konfiguration anzulegen:

1. Öffnen Sie im Hauptmenü Nextcloud-Synchronisierung einrichten und klicken Sie auf + (Neue Konfiguration erstellen).
   
   Ergebnis: Das Fenster Neue Nextcloud-Synchronisierung einrichten öffnet sich.
2. Geben Sie einen Konfigurationsnamen ein. Erlaubt sind Buchstaben ohne Umlaute, Ziffern, Bindestrich und Unterstrich. Nach dem Speichern lässt sich der Name nicht mehr ändern.
3. Lassen Sie Konfiguration aktiv angehakt. Nur aktive Konfigurationen werden synchronisiert.
4. Geben Sie unter Anmeldedaten die Nextcloud-Adresse ein. Kopieren Sie sie aus der Browser-Zeile Ihrer Nextcloud-Anmeldeseite.
5. Geben Sie Benutzername und Passwort ein.
6. Klicken Sie auf Anmelden.
   
   Ergebnis: Die Anmeldedaten sind geprüft und gesperrt, Sie können Regeln anlegen. Um sie zu ändern, klicken Sie auf Anmeldedaten bearbeiten.
7. Legen Sie die Regeln an, siehe Regeln für die Nextcloud-Synchronisierung festlegen.
8. Klicken Sie auf Konfiguration speichern.
   
   Ergebnis: Sie haben die Konfiguration gespeichert, das Passwort ist verschlüsselt gespeichert. Das Fenster schließt sich, die Auswahl zeigt die neue Konfiguration. Die erste Synchronisierung startet mit der nächsten Prüfung des Tasks, meist innerhalb einer Minute, als Full-Scan.

Der Statustext in der Einrichtung nennt den nächsten Differential-Scan, den nächsten Full-Scan und das Ergebnis der letzten Synchronisierung. Abbrechen schließt die Einrichtung; bei ungespeicherten Änderungen fragt agorum core, ob Sie speichern oder verwerfen möchten.

Konfiguration löschen steht beim Bearbeiten einer gespeicherten Konfiguration zur Verfügung und fragt nach. Danach wird nichts mehr synchronisiert; Ihre Dateien in agorum core und in Nextcloud bleiben erhalten. Den Namen einer gelöschten Konfiguration können Sie nicht erneut verwenden.

Wenn die Anmeldung scheitert

Scheitert die Anmeldung bei Integration | Nextcloud, steht der Grund rot unter den Anmeldedaten.

Grund	Was Sie tun
Nextcloud hat die Anmeldung abgelehnt	Adresse samt Pfad hinter dem Hostnamen, Benutzername und Passwort prüfen; bei Zwei-Faktor-Anmeldung ein App-Passwort verwenden.
Zertifikat nicht vertrauenswürdig	An den Administrator wenden.
Zertifikat passt nicht zur Adresse	Adresse aus der Browser-Zeile der Nextcloud-Anmeldeseite kopieren; hilft das nicht, an den Administrator wenden.
Nextcloud unter dieser Adresse nicht erreichbar	Adresse prüfen.
Unerwartete Antwort mit HTTP-Status	Adresse prüfen oder später erneut versuchen.

Regeln für die Nextcloud-Synchronisierung festlegen

Eine Regel in Integration | Nextcloud legt fest, welcher Ordner in agorum core mit welchem Ordner in Nextcloud synchronisiert wird und wie.

Regel anlegen

Voraussetzung: Die Konfiguration ist geöffnet und die Anmeldung war erfolgreich.

1. Klicken Sie unter Regeln auf + oder auf den Stift einer vorhandenen Regel.
2. Klicken Sie neben Pfad in agorum core auf die drei Punkte und wählen Sie einen Ordner unter Dateien (/agorum/roi/Files).
3. Klicken Sie neben Pfad in Nextcloud auf die drei Punkte und wählen Sie den Ordner in Nextcloud.
4. Stellen Sie Richtung, Master, Löschen und Notizen ein.
5. Klicken Sie auf OK.
   
   Ergebnis: Die Regel steht in der Tabelle, ist aber noch nicht gespeichert.
6. Klicken Sie auf Konfiguration speichern.
   
   Ergebnis: Sie haben die Regel gespeichert; sie wird beim nächsten Lauf synchronisiert.

Richtung, Master, Löschen und Notizen können Sie auch direkt in der Tabellenzeile ändern. Ändern Sie einen Ordner einer Regel, gilt sie als neue Regel ohne bisherigen Synchronisierungsstand.

Einstellungen einer Regel

Einstellung	Bedeutung	Vorgabe
Richtung	Bidirektional, agorum core nach Nextcloud oder Nextcloud nach agorum core	Bidirektional
Master (Konfliktlösung)	Welche Seite gewinnt, wenn dieselbe Datei auf beiden Seiten geändert wurde	Nextcloud
Löschen in agorum core	In Nextcloud gelöschte Dateien auch in agorum core löschen (Papierkorb)	an
Löschen in Nextcloud	In agorum core gelöschte Dateien auch in Nextcloud löschen (Papierkorb)	an
Notizen	Notizen in agorum core und Kommentare in Nextcloud übertragen	aus

Bei agorum core nach Nextcloud ist agorum core Master, gelöscht wird nur in Nextcloud. Bei Nextcloud nach agorum core ist Nextcloud Master, gelöscht wird nur in agorum core. Wechseln Sie danach zurück auf Bidirektional, bleiben Master und Löschschalter so stehen; prüfen Sie sie dann. Ist ein Löschschalter aus, bleibt die Datei auf der anderen Seite erhalten und kommt mit dem nächsten Full-Scan zurück.

Doppelte und überlappende Regeln

Beim Speichern vergleicht Integration | Nextcloud jede Regel mit Ihren anderen Regeln und mit den Regeln aller anderen Benutzer. Zwei Ordner überlappen, wenn sie gleich sind oder einer im anderen liegt.

• Überlappen bei demselben Nextcloud-Konto die Ordner in Nextcloud und die Ordner in agorum core, lässt sich die Konfiguration nicht aktiv speichern, weil die Dateien bei jedem Lauf hin und her übertragen würden.
• Überlappen nur die Ordner in agorum core, ist das erlaubt: agorum core gibt Änderungen zwischen den Regeln weiter, etwa zwischen zwei Nextcloud-Konten. Wird dieselbe Datei an beiden Stellen in Nextcloud gleichzeitig geändert, gewinnt die Regel, die zuerst synchronisiert wird. Beim Speichern kommt dazu eine Warnung mit der Frage Trotzdem speichern?

Eine Regel, die eine frühere Version inaktiv gesetzt hat, steht in der Spalte Status als „inaktiv“. In der Regel-Maske aktivieren Sie sie mit Regel aktivieren.

Mit Nextcloud synchronisieren und das Protokoll lesen

Integration | Nextcloud synchronisiert automatisch nach den Zeitplänen Ihres Administrators. Eine zusätzliche Synchronisierung stoßen Sie von Hand an.

Von Hand synchronisieren

Klicken Sie in Ihrer Konfiguration auf Synchronisieren oder im Kontextmenü des Ordners auf Mit Nextcloud synchronisieren. Ungespeicherte Änderungen werden gespeichert, eine Synchronisierung wird eingereiht und das Protokoll öffnet sich. Die Synchronisierung startet innerhalb von etwa einer Minute, sobald ein Platz frei ist.

• Eine Synchronisierung von Hand ist ein Differential-Scan. Was erst der Full-Scan nachholt, kommt dadurch nicht früher an.
• Die erste Synchronisierung einer Konfiguration ist immer ein Full-Scan und kann länger dauern.
• Wartet oder läuft schon eine Synchronisierung, meldet das Protokoll das.
• Hat der Administrator den Task gestoppt, wird nichts eingereiht.

Protokoll lesen

Protokoll öffnet das Protokoll, ohne zu synchronisieren. Es zeigt die letzten 300 Einträge, neueste zuerst, mit den Spalten Zeit, Regel, Was ist passiert, Datei oder Ordner und Hinweis.

• Nur Fehler und Warnungen blendet die übrigen Einträge aus; Fehler sind fett.
• Protokolldateien öffnet die rohen Protokolldateien, etwa für den Support.
• Solange eine Synchronisierung wartet oder läuft, aktualisiert sich das Protokoll von selbst. Aktualisieren lädt Status und Einträge neu.

Synchronisierte Objekte an der Card erkennen

Ordner mit einer aktiven Regel von Integration | Nextcloud und alle Objekte darin zeigen an ihrer Card den Chip Nextcloud, bei der Synchronisierung von Notizen zusätzlich Notizen. Ein Klick auf Nextcloud blendet je Regel ein, wer die Synchronisierung eingerichtet hat, die Konfiguration, die Richtung, ob Notizen übertragen werden, und die nächste Synchronisierung. Nextcloud-Adresse, Konto und Ordner zeigt die Card nicht.

Verhalten bei der Synchronisierung mit Nextcloud

Integration | Nextcloud kennt zwei Arten der Synchronisierung: Der Differential-Scan überträgt häufig, was sich seit dem letzten Lauf geändert hat. Der Full-Scan vergleicht selten, etwa nachts, den ganzen Bestand und holt nach, was der Differential-Scan nicht erkannt hat. Wann beide laufen, legt Ihr Administrator fest; die Zeitpunkte sehen Sie im Statustext Ihrer Einrichtung.

Was erst mit dem Full-Scan ankommt

Neue, geänderte, umbenannte und verschobene Dateien und Ordner überträgt der Differential-Scan, ebenso Notizen, die Sie in agorum core anlegen oder bearbeiten, und neue Kommentare in Nextcloud. Erst mit dem nächsten Full-Scan kommen an:

• in Nextcloud gelöschte Dateien, wenn Nextcloud die Löschung nicht in seinen Aktivitäten meldet
• geänderte und gelöschte Kommentare in Nextcloud sowie gelöschte Notizen in agorum core
• Dateien in einem Nextcloud-Ordner, der wegen Groß- und Kleinschreibung blockiert war
• Dateien, die wegen der maximalen Dateigröße übersprungen wurden, nachdem Ihr Administrator die Grenze angehoben hat
• Dateien, die auf einer Seite gelöscht wurden, während der passende Löschschalter aus ist: Sie kommen von der anderen Seite zurück

Konflikte und Löschen

• Wurde dieselbe Datei seit der letzten Synchronisierung auf beiden Seiten geändert, gewinnt der Master der Regel; die überschriebene Fassung bleibt in den Versionen der Datei erhalten. Wurde nur eine Seite geändert, kommt die Änderung immer an. Benennt eine Seite eine Datei um und ändert die andere ihren Inhalt, kommen beide Änderungen an.
• Liegen bei der ersten Synchronisierung einer Regel auf beiden Seiten schon Objekte am selben Pfad, werden Ordner ohne Übertragung verknüpft. Bei Dateien überschreibt die Fassung des Masters die andere Seite, bei einer Regel in nur eine Richtung die Fassung der Quelle.
• Ist agorum core Master und wurde eine Datei kurz vor der Synchronisierung in agorum core und zugleich in Nextcloud geändert, übernimmt agorum core die Fassung aus Nextcloud nicht. Das Protokoll zeigt „In agorum core nicht überschrieben“. Eine spätere Synchronisierung, spätestens der Full-Scan, überträgt die Fassung aus agorum core nach Nextcloud.
• Löschen Sie in Nextcloud eine Datei oder einen Ordner und legen gleich wieder einen mit demselben Namen an, bleibt das Objekt in agorum core erhalten und bekommt den neuen Inhalt. Bei einem Ordner kommen die neuen Inhalte an; was nur im alten Ordner lag, entfernt der nächste Full-Scan. Ersetzen Sie eine Datei auf diese Weise in agorum core, geht die neue Datei nach Nextcloud.
• Liegt am Ziel einer Umbenennung oder Verschiebung auf der anderen Seite schon ein anderes Objekt, wird nicht verschoben. Das Protokoll zeigt „Verschieben nicht möglich: Am Ziel liegt schon ein anderes Objekt“, die Synchronisierung endet mit Warnungen.
• Gelöschtes landet auf der anderen Seite im Papierkorb, nicht endgültig.
• Löschen Sie in agorum core einen Ordner, kommt er in Nextcloud samt Inhalt in den Papierkorb, auch wenn dort eine Datei darin inzwischen geändert wurde. Sie lässt sich aus dem Papierkorb von Nextcloud wiederherstellen.
• Eine Änderung, die wenige Sekunden vor einer Synchronisierung entsteht, kommt erst mit der nächsten Synchronisierung an.
• Ein Objekt, das Sie aus dem synchronisierten Ordner hinausverschieben, gilt für die Synchronisierung als gelöscht.
• Umbenennen und Verschieben innerhalb des synchronisierten Ordners kommen auf der anderen Seite als Umbenennen oder Verschieben an; das Protokoll nennt den vorherigen Pfad.

Notizen und Kommentare

• Eine Notiz wird nur in die Richtung aktualisiert, in der sie entstanden ist.
• Aus Nextcloud kommende Notizen beginnen mit [NC: Benutzer] (Benutzername in Nextcloud), nach Nextcloud übertragene Kommentare mit [agorum: Benutzer] (vollständiger Name in agorum core).
• Formatierungen gehen nach Nextcloud verloren, dort gibt es nur Klartext.
• Geänderte und gelöschte Kommentare in Nextcloud und gelöschte Notizen in agorum core kommen erst mit dem Full-Scan an.

Was nicht übertragen wird

• Verknüpfungen, Metadaten, Berechtigungen und ältere Versionen
• Dateien über der maximalen Dateigröße; sie stehen im Protokoll als „Übersprungen: Die Datei ist zu groß“
• Objekte im Papierkorb

Liegen in einem Nextcloud-Ordner zwei Einträge, die sich nur in Groß- und Kleinschreibung unterscheiden, blockieren sie den Ordner samt Unterordnern; das Protokoll zeigt das als Fehler. Benennen Sie einen davon in Nextcloud um. Was in der Zwischenzeit in diesem Ordner in Nextcloud neu entstanden ist, holt der nächste Full-Scan nach, nicht schon der Differential-Scan.