Verwendung der Nextcloud-Integration

Ab OpenProject 12.2 können Sie Nextcloud als integrierten Datei-Speicher in OpenProject verwenden.

Diese Integration ermöglicht es Ihnen:

  • Dateien und Ordner in Nextcloud mit Arbeitspaketen in OpenProject zu verknüpfen
  • Dateien und Ordner, die mit einem Arbeitspaket verknüpft sind, über den Dateien-Reiter anzusehen, zu öffnen und herunterzuladen
  • Alle mit einer Datei verknüpften Arbeitspakete anzuzeigen
  • OpenProject Benachrichtigungen über das Nextcloud Dashboard anzeigen zu lassen

Hinweis: Die Mindestvoraussetzungen für diese Integration sind Nextcloud Version 22 (oder höher) und OpenProject Version 12.2 (oder höher). Um Nextcloud als Daten-Speicher in Ihrem Projekt verwenden zu können, sollte der Administrator Ihrer Instanz zuerst das Nextcloud Integration Setup abgeschlossen haben.

Thema Beschreibung
Verbinden Sie Ihr OpenProject-Konto mit Ihrem Nextcloud-Konto Wie Sie Ihre Nextcloud und OpenProject Konten verbinden, um diese Integration nutzen zu können
Verknüpfen Sie Dateien und Ordner mit Arbeitspaketen Wie Sie Dateien und Ordner mit Arbeitspaketen verlinken, ansehen und herunterladen
Verknupfung zu Dateien und Ordnern aufheben Wie Sie die Verknüpfung zwischen Arbeitspaket und Nextcloud-Datei oder -Ordner entfernen
Berechtigungen und Zugriffskontrolle Wer hat Zugriff auf verknüpfte Dateien und wer nicht
Mögliche Fehler und Fehlerbehebung Häufige Fehler und wie man sie behebt

Verbinden Sie Ihr OpenProject-Konto mit Ihrem Nextcloud-Konto

Um diese Integration zu verwenden, müssen Sie zuerst Ihr OpenProject-Konto mit Ihrem Nextcloud-Konto verbinden. Dazu öffnen Sie ein beliebiges Arbeitspaket in einem Projekt, in dem ein Nextcloud-Dateispeicher von einem Administrator hinzugefügt und aktiviert wurde und folgen diesen Schritten:

  1. Gehen Sie zum Dateien-Reiter und klicken Sie unter der Nextcloud-Überschrift auf Nextcloud Login. NC Login

  2. Sie werden einen Nextcloud-Bildschirm sehen, in dem Sie sich einloggen müssen, bevor Sie OpenProject Zugriff auf Ihr Nextcloud Konto gewähren. Sie werden außerdem eine Sicherheitswarnung sehen, aber da Sie tatsächlich versuchen, die beiden Konten zu verbinden, können Sie diese gefahrlos ignorieren. Klicken Sie auf Anmelden und geben Sie Ihre Nextcloud Zugangsdaten ein. NC Login Schritt 2

    NC Login Schritt 2

  3. Sobald Sie in Nextcloud eingeloggt sind, klicken Sie auf den Zugriff gewähren -Button, um zu bestätigen, dass Sie OpenProject Zugriff auf Ihr Nextcloud Konto geben möchten. NC Login Schritt 2

  4. Sie werden nun zurück zu OpenProject weitergeleitet, wo Sie außerdem gebeten werden, Nextcloud über die API Lese- und Schreibzugriff auf Ihr OpenProject-Konto zu gewähren. Dies ist notwendig, damit die Integration funktioniert. Klicken Sie auf Autorisieren. NC Login Schritt 2

  5. Der einmalige Prozess um Ihre beiden Konten zu verbinden, ist abgeschlossen. Sie werden nun zum ursprünglichen Arbeitspaket zurückgeleitet, wo Sie alle Nextcloud Dateien, die bereits verlinkt sind, anzeigen und öffnen oder mit der Verknüpfung von neuen Dateien beginnen können.

Hinweis: um die Verbindung zwischen Ihren OpenProject und Nextcloud Konten zu trennen, navigieren Sie in Nextcloud zu Einstellungen → Verbundene Konten. Dort klicken Sie auf Verbindung zu OpenProject trennen. Um die beiden Konten erneut zu verknüpfen, befolgen Sie einfach die obigen Anweisungen erneut.

Dateien und Ordner mit Arbeitspaketen verknüpfen

Das folgende Video gibt Ihnen einen kurzen Überblick über die Verwendung dieser Integration:

Dieses Video ist derzeit nur in englischer Sprache verfügbar.

Das Verknüpfen von Dateien zu OpenProject-Arbeitspaketen ist derzeit nur über Nextcloud verfügbar. Navigieren Sie zunächst in Nextcloud zu der Datei oder dem Ordner, den Sie mit einem Arbeitspaket verknüpfen möchten, und klicken Sie auf die drei Punkte → Details.

NC Öffnen von Dateidetails

In der Details-Seitenleiste, klicken Sie auf den OpenProject-Reiter. In diesem Reiter können Sie Arbeitspakete in OpenProject mit der aktuellen Datei verknüpfen. Außerdem werden alle verknüpften Arbeitspakete hier aufgelistet. Wenn noch nichts verlinkt ist, ist die Liste leer. Um diese Datei zum ersten Mal mit einem Arbeitspaket in OpenProject zu verknüpfen, nutzen Sie die Suchleiste, um das korrekte Arbeitspaket zu finden (Sie können entweder nach einem Wort im Titel Ihres Arbeitspakets suchen oder einfach die Arbeitspaket-ID eingeben) und klicken Sie auf das gewünschte Arbeitspaket.

NC leerer Status

NC Arbeitspaketsuche

Diese verlinkte Datei wird dann unterhalb der Suchleiste angezeigt. Auf diese Weise wird die Datei automatisch zum Dateien-Reiter im entsprechenden Arbeitspaket in OpenProject hinzugefügt.

NC Arbeitspaketbeziehung

Nachdem ein Arbeitspaket mit einer Datei verknüpft ist, können Sie die Verlinkung jederzeit entfernen, indem Sie auf das Unlink-Symbol klicken.

NC unlink WP

Zusätzlich zu Aktionen im Zusammenhang mit einzelnen Dateien können Sie auswählen, ob das OpenProject-Widget auf Ihrem Nextcloud-Dashboard angezeigt werden soll, damit Sie Ihre OpenProject-Benachrichtigungen im Blick behalten können. NC Widget hinzufügen

NC Widget hinzugefügt

Es gibt drei zusätzliche Funktionen im Zusammenhang mit der Integration, die Sie in Nextcloud aktivieren können. In Ihren persönlichen Einstellungen unter Verbundene Konten finden Sie folgende Optionen:

  • Navigations-Link aktivieren zeigt einen Link zu Ihrer OpenProject Instanz in der Nextcloud Kopfzeile an
  • Einheitliche Suche nach Tickets aktivieren ermöglicht den Zugriff auf OpenProject Arbeitspakete über die universelle Suchleiste in Nextcloud
  • Benachrichtigungen für Aktivitäten in meinen Arbeitspaketen aktivieren sendet Ihnen Benachrichtigungen, wenn es Aktualisierungen zu verknüpften OpenProject Arbeitspaketen gibt

NC Zusatzeinstellungen

NC Zusatz Navigations-Link

NC Zusatz Suche

Hinweis: In dieser Version der Integration können Sie nur Dateien mit Arbeitspaketen auf Nextcloud verknüpfen; das Hinzufügen eines neuen Links zu einer Nextcloud-Datei über die OpenProject-Schnittstelle ist noch nicht möglich, wird aber in naher Zukunft möglich sein.

Verknüpfungen zu Dateien und Ordnern aufheben

Wenn Sie die Verknüpfung einer Datei oder eines Ordners aufheben möchten, bewegen Sie den Mauszeiger in der Liste der verknüpften Dateien darauf und klicken Sie auf das Symbol Verknüpfung aufheben neben Löschen-Symbol.

Ein Screenshot des Verknüpfung-Entfernen-Symbols beim Bewegen der Maus über einer verknüpften Datei

Sie werden aufgefordert, zu bestätigen, dass Sie die Verknüpfung aufheben möchten. Klicken Sie dazu auf Verknüpfung entfernen.

Info: Das Aufheben der Verknüpfung einer Datei oder eines Ordners entfernt einfach die Verbindung mit diesem Arbeitspaket; die ursprüngliche Datei oder der ursprüngliche Ordner wird nicht gelöscht oder in irgendeiner Weise beeinträchtigt. Die einzige Änderung besteht darin, dass es nicht mehr auf der Registerkarte „Dateien“ in OpenProject angezeigt wird und das Arbeitspaket nicht mehr auf der Registerkarte „OpenProject“ für diese Datei auf Nextcloud aufgeführt wird.

Berechtigungen und Zugriffskontrolle

Wenn eine Nextcloud-Datei oder ein -Ordner mit einem Arbeitspaket verknüpft ist, wird ein OpenProject-Nutzer, der Zugriff auf dieses Arbeitspaket hat, in der Lage sein:

  • Den Namen der verknüpften Datei oder des verknüpften Ordners zu sehen
  • Zu sehen, wann die Datei oder der Ordner zuletzt modifiziert (oder kreiert, falls noch keine Änderungen durchgeführt wurden) wurde
  • Zu sehen, wer die Datei oder den Ordner zuletzt bearbeitet hat (oder wer sie erstellt hat, falls noch keine Änderungen durchgeführt wurden)

Alle verfügbaren Aktionen hängen jedoch von den Berechtigungen ab, die der OpenProject-Nutzer (oder genauer gesagt das Nextcloud-Konto, das an diesen Benutzer gebunden ist) in Nextcloud hat. Mit anderen Worten, ein Nutzer, dem die Berechtigungen fehlen, auf die Datei in Nextcloud zuzugreifen, wird ebenfalls nicht in der Lage sein, sie zu öffnen, modifizieren, herunterzuladen oder die Verknüpfung in OpenProject zu löschen.

Mögliche Fehler und Fehlerbehebung

Fehlende Berechtigung, um diese Datei zu sehen

Wenn Sie die Details einer Datei nicht sehen können oder nicht in der Lage sind, einige der mit einem Arbeitspaket verknüpften Dateien zu öffnen, könnte es daran liegen, dass Ihr Nextcloud-Konto nicht die nötigen Berechtigungen besitzt. In einem solchen Fall können Sie den Namen, die Zeit der letzten Änderung sowie den Namen des Nutzers, der die letzte Änderung ausgeführt hat, sehen, aber keine weiteren Aktionen durchführen. Um diese Dateien zu öffnen oder darauf zuzugreifen, wenden Sie sich bitte an Ihren Nextcloud Administrator oder den Ersteller der Datei, damit er Ihnen die nötigen Berechtigungen erteilen kann.

OP Keine Berechtigungen

Benutzer nicht in Nextcloud eingeloggt

Wenn Sie die Worte “Einloggen in Nextcloud” sehen, wo sie normalerweise die Liste der verknüpften Dateien im Datei-Reiter in OpenProject sehen, liegt es daran, dass sie sich aus Nextcloud ausgeloggt haben (oder automatisch ausgeloggt wurden). Alternativ könnten Sie mit einem anderen Konto als dem eingeloggt sein, das Sie mit OpenProject nutzen.

In diesem Fall können Sie weiterhin die Liste der verknüpften Dateien sehen, aber keine Aktionen durchführen. Um die volle Funktionalität wiederherzustellen, loggen Sie sich einfach in Ihr Nextcloud-Konto ein.

OP Login-Fehler

Verbindungsfehler

Wenn Sie die Worte “Keine Nextcloud-Verbindung” im Dateien-Reiter in OpenProject sehen, hat Ihre OpenProject Instanz Probleme mit der Verbindung zu Ihrer Nextcloud Instanz. Hierfür kann es verschiedene Gründe geben. Die beste Vorgehensweise ist es, sich mit dem Administrator Ihrer OpenProject- und Nextcloud-Instanzen in Verbindung zu setzen, um das Problem zu identifizieren und zu beheben.

OP Verbindungsfehler

Fehler beim Abrufen der Datei

In seltenen Fällen ist es möglich, dass die Integration nicht alle Details aller verknüpften Dateien abrufen kann. Eine einfache Aktualisierung der Seite sollte das Problem lösen. Sollte der Fehler weiterhin bestehen, kontaktieren Sie bitte den Administrator Ihrer OpenProject und Nextcloud Instanzen.

OP Abruffehler

Projektbenachrichtigungen werden in Nextcloud nicht angezeigt

Wenn OpenProject Benachrichtigungen nicht korrekt in Nextcloud angezeigt werden, navigieren Sie zu Nextcloud Einstellungen → Grundeinstellungen → Hintergrundjobs und stellen Sie sicher, dass Cron ausgewählt ist.

NC Benachrichtigungen nicht angezeigt