D-DOK Forschungsdokumentation

• Videos
• Projekte Seite
• Publikationen Seite
• Benutzerverwaltung Seite
• Systemberechtigungen Seite
• Projektkategorie Seite
• Publikationstyp Seite
• Schlagwörter Seite
• Kostenträger Seite
• Berichtsverwaltung Seite
• Serverprotokolle Seite
• 0.0.2 Versionshinweise 19.02.2025
• 0.0.4 Versionshinweise 17.06.2025
• Systemadministration

Videos

D-DOK Einführung

D-DOK Publikation hinzufugen

Projekte Seite

Projekte Liste ansicht

Auf der Projektseite wird eine Liste aller Projekte angezeigt, die der aktuell angemeldete Benutzer sehen darf.
Ein Projekt ist sichtbar, wenn das Projekt "intern verfügbar" ist oder wenn der aktuelle Benutzer Mitglied der von einem Administrator definierten „Projektbenutzer“ ist.

Das "Suche" feld filtert die angezeigten Projekte anhand einer Volltextsuche nach Projekttitel und -beschreibung.

Über die Checkbox „Laufend“ lässt sich die Liste auf Projekte einschränken, deren aktuelles Datum zwischen dem beim Projekt angegebenen Start- und Enddatum liegt.

Das Dropdown-Menü „Projektkategorie“ filtert die Liste nach Projekten, die der angegebenen Kategorie zugeordnet sind.

Darüber hinaus kann die Liste über das Kontrollkästchen „Leiter“ und das Dropdown-Menü „Teammitglied“ oder „Projektleiter“ entweder nach Projektleiter oder Teammitglied gefiltert werden.

Durch Drücken der Schaltfläche "X" werden alle Filter einstellingen entfernt.

Wenn Sie auf ein Projekt klicken, werden die Projektdetails angezeigt. das zuvor ausgewählte Projekt wird grau hinterlegt.

Projekte Detail ansicht

In der Projektdetailansicht werden alle Informationen zum ausgewählten Projekt angezeigt.

Wenn der aktuell angemeldete Benutzer ein Projektadministrator mit der Berechtigung „Projekt bearbeiten“ ist, wird eine Schaltfläche „Bearbeiten“ angezeigt, und mit der Berechtigung „Projekt löschen“ wird eine Schaltfläche „Löschen“ angezeigt. Projekte können nur gelöscht werden, wenn keine zugehörigen Publikationen vorhanden sind.

Wenn der Administratorbenutzer die Berechtigung „Projektbenutzer verwalten“ hat, wird eine Schaltfläche zum Öffnen der Schublade mit den Projektbenutzerberechtigungen angezeigt.

In der Detailansicht sind zudem Links zu allen Publikationen zu diesem Projekt enthalten, mit der Anzeige von Checks, ob die Publikationen "Im Projekt verfügbar" und "auf der Website" sind, sowie dem Veröffentlichungsdatum.

Projekte Detail / Projektbenutzer ansicht

Über die Projektbenutzeransicht kann ein Administrator festlegen, wer das Projekt und die zugehörigen Publikationen sehen darf.

Projekte, die NICHT als „Intern verfügbar“ gekennzeichnet sind (und die zugehörigen Veröffentlichungen) können nur von den Benutzern in dieser Liste gesehen werden.
„Intern verfügbar“-Projekte (und deren Veröffentlichungen) können von allen internen Benutzern gesehen werden.

Über den „+“-Button können Benutzer hinzugefügt werden.

Bei der Verknüpfung von D-DOK mit D-ESS gibt es zusätzlich einen Button (Benutzer mit Plus-Symbol), über den alle Benutzer hinzugefügt werden, die aktuell auf den mit dem ausgewählten Projekt verknüpften Kostenträger buchen können.

Für jeden Benutzer legt die Checkbox „ADMIN“ fest, ob der Benutzer administrieren darf (bearbeiten, Publikationen hinzufügen oder andere Benutzer zum Projekt hinzufügen). Zudem ist es erforderlich, dass Benutzer, die das Projekt administrieren dürfen, Mitglied einer Sicherheitsgruppe mit den erforderlichen Berechtigungen sind.

Projekte Bearbeiten ansicht

Projektadministratoren mit der Erlaubnis „Projekt bearbeiten“ können die Projektdetails bearbeiten.

Das Kontrollkästchen „Intern verfügbar“ bestimmt, ob das Projekt und alle zugehörigen Veröffentlichungen intern für alle Benutzer sichtbar sind. Wenn dies nicht aktiviert ist, sind das Projekt und die zugehörigen Veröffentlichungen nur für die Projektbenutzer sichtbar.

Die Kontrollkästchen „Auf der Website“ bestimmt, ob das Projekt auf der Website veröffentlicht wird. Ist diese Checkbox nicht aktiviert, werden das gesamte Projekt sowie die zugehörigen Publikationen und Dateien NICHT auf der Website angezeigt. Diese Checkbox ist deaktiviert, es sei denn, der aktuelle Benutzer verfügt über die Systemberechtigung „Projekt auf der Website Checkbox ändern“.

Schlagwörter, die das Projekt beschreiben, können aus einem Dropdown-Baum ausgewählt werden (von Administratoren auf der Schlagwörterseite definiert).

Jedes Projekt muss einen Titel, einen zugehörigen Kostenträger, eine Projektkategorie und eine Beschreibung haben. Die anderen Felder sind optional.

Es ist möglich, 3 Personen als Projektleiter zuzuordnen. Dies können interne Benutzer (in der Benutzerverwaltung) oder externe sein, in diesem Fall gibt es eine Freitexteingabe. Bei externen Benutzern formatieren Sie den Leiternamen bitte als „Nachname, Vorname“.
Der Plus-Button unter den Teamleitern ermöglicht die Eingabe des Projektteams

Drei Textfelder (Freitext) sind auch für die DAFNE, SAP Kostenstelle und Abteilung Kostenstelle vorgesehen.

Die Beschreibung ist eine „Rich Text“-Eingabe, kann also nach Bedarf formatiert werden.

Publikationen Seite

Publikationen Liste ansicht

Auf der Publikationenseite wird eine Liste aller Publikationen angezeigt, die der aktuell angemeldete Benutzer sehen darf.

Eine Publikation ist nach diesen Regeln sichtbar:

1. Die Publikation ist „privat“ (nicht „im Projekt verfügbar“) und der aktuelle Benutzer ist der Eigentümer der Veröffentlichung.

2. Die Publikation ist „im Projekt verfügbar“, das zugehörige Projekt ist NICHT „intern verfügbar“ und der aktuelle Benutzer befindet sich auf der Liste der „Projektbenutzer“ (nur für ein Projektteam sichtbar).

3. Die Veröffentlichung ist „im Projekt verfügbar“ und das zugehörige Projekt ist „intern verfügbar“.

Das Feld „Suchen“ filtert die angezeigten Publikationen mittels Volltextsuche nach Projektname, Beschreibung, zugehörigen Dateibeschreibungen und optional (bei aktivierter Checkbox PDFs durchsuchen) nach den Textinhalten der hochgeladenen PDF-Dateien.

Zusätzlich kann die Liste nach Veröffentlichungsjahr, Publikationstyp und Autor gefiltert werden.

Durch Drücken der Schaltfläche "X" werden alle Filter entfernt.

Wenn Sie auf ein Publikation klicken, werden die Publikationdetails angezeigt. das zuvor ausgewählte Publikation wird grau hinterlegt.

Publikation Detail ansicht

Benutzerverwaltung Seite

Systemberechtigungen Seite

Projektkategorie Seite

Publikationstyp Seite

Schlagwörter Seite

Kostenträger Seite

Berichtsverwaltung Seite

Serverprotokolle Seite

0.0.2 Versionshinweise 19.02.2025

Fehlerbehebungen

1. Flackern in der Liste beim langsamen Scrollen

Die Projekt- und Publikationslistenseiten verwenden einen virtuellen Scroll-Mechanismus, der die Darstellung von potenziell Tausenden von Elementen auf der Liste ermöglicht, ohne die Browserleistung zu beeinträchtigen.

Diese Implementierung hatte einen Fehler, der dazu führte, dass die Liste beim langsamen Scrollen flackerte.

Ich habe die Implementierung ausgebessert, um dieses Flackern zu verhindern.

(wird zurückgesetzt, sobald dieses Problem in der offiziellen Angular-Materialbibliothek behoben wurde

2. Publikationsbeschreibung nicht mehr erforderlich

Karin Heinschink: Bei den Publikationen gibt es zwei Beschreibungsfelder. Wenn im Beschreibungsfeld neben dem Anhang etwas eingetragen ist, kann ich nicht speichern. Wenn ich die Beschreibung im Feld ganz unten eintrage, kann ich speichern.

Manche Publikationen bestehen nur aus einer PDF-Datei (die bereits ein Beschreibungsfeld für die Datei enthält). In diesem Fall ist es nicht notwendig, zusätzlich eine Beschreibung der Publikation einzugeben.

Um dies zu ermöglichen, ist das Beschreibungsfeld für Publikationsn kein Pflichtfeld mehr.

3. Publikation Veröffentlichungsdatum als pflichtfeld markiert

Karin Heinschink: Scheinbar muss das Feld „Veröffentlichungsdatum“ ausgefüllt werden, damit der Publikationseintrag gespeichert werden kann. Daher ein * einfügen? 

Umgesetzt :)

4. Projektbenutzer erklärung

Karin Heinschink: Was wird hier (Projektbenutzer) gesteuert? Wo wird das Projekt angezeigt? Wo wird veröffentlicht?

Ich habe den Text auf dieser Seite aktualisiert, der beschreibt, wie die Projekttbenutzerliste funktioniert, und auch die Dokumentation hier aktualisiert:

https://doku.agrarforschung.at/books/d-dok-forschungsdokumentation/page/projekte-seite

https://doku.agrarforschung.at/books/d-dok-forschungsdokumentation/page/publikationen-seite

5. Der Publikationseigentümer wird nicht angezeigt und kann nicht geändert werden.

Der „Eigentümer“ einer Publikation ist zunächst der Uploader.

Wenn eine Publikation nicht als „im Projekt verfügbar“ gekennzeichnet ist, ist sie grundsätzlich privat und kann nur vom Eigentümer angezeigt und bearbeitet werden.

Der Name des Eigentümers wird jetzt in den Publikationsdetails angezeigt, was das System viel transparenter macht.

Darüber hinaus können Administratoren mit der Systemberechtigung „Alle Projekte und Publikationen verwalten“ jetzt ALLE private Publikationen anzeigen, editieren, und den Eigentümer beim Bearbeiten der Publikation ändern.

Dies war ein Versehen im ursprünglichen System, bei dem eine Publikation möglicherweise für niemanden mehr verfügbar war, wenn ein Benutzer das BAB verließ, ohne seine privaten Publikationen zuvor anderen Teammitgliedern im Projekt zur Verfügung zu stellen.

Neue Funktionen

1. Projektteams

In Version 0.0.1 waren Projekte nur Projektleitern zugeordnet. Ich habe eine neue Funktion implementiert, mit der Projekte auch Teammitgliedern zugeordnet werden können. Dies entspricht der Funktionalität, die wir auf der BAB-Website sehen.

Unter den Teamleitern befindet sich eine neue Schaltfläche „+“, die eine Auswahlsteuerung für ein Teammitglied hinzufügt

Ich habe alle bestehenden Projekte durchgesehen und die Teammitglieder miteinbezogen, die auf der BAB-Website sind.

Darüber hinaus gibt es auf der Projektlistenseite eine Filtersteuerung, mit der die Liste entweder nach Projektleiter oder nach Projektteammitgliedern gefiltert werden kann

2. Schlagwörter

Auf der BAB-Website ist es möglich, Schlagwörter sowohl Projekten als auch Publikationen zuzuordnen, sodass beide nach „Thema“ durchsucht werden können.

Ich habe diese Funktion jetzt implementiert, um diese Funktion in zukünftigen Versionen von D-DOK zu ermöglichen, die die Daten auf die Website exportieren.

Es gibt eine neue Administratorseite, auf der ein zweistufiger Kategorienbaum (Schlagwörter) eingegeben werden kann:

Die vollständige Liste der derzeit auf der BAB-Website verfügbaren Schlagwörter wurde auf den Staging-Server übertragen und ALLE bestehenden Projekte und Publikationen wurden den entsprechenden Schlagwörtern zugeordnet.

die Projekt- und Publikationsdetailseiten zeigen nun die zugehörigen Schlagwörter:

Beim Bearbeiten von Projekten und Publikationen gibt es jetzt ein Dropdown-Auswahlfeld mit Mehrfachauswahl (filterbar)

3. Laufende projekte filter

Karin Heinschink: Wäre es leicht umzusetzen, dass man bei den Projekten auch filtern kann nach „laufende Projekte“ (z.B. Hakerl setzen), ev. auch nach „abgeschlossene Projekte“? Oder gibt es dazu dann eine eigene Auswertung / Abfrage?

Auf der Projektlistenseite gibt es jetzt ein Checkbox, mit der der Suchfilter nur „laufende“ Projekte einschließen kann.

Ich habe keinen Filter für abgeschlossene Projekte implementiert.
Bitte überprüfen Sie diese Funktionalität und prüfen Sie, ob dieser Filter die Anforderungen erfüllt.

4. Projektpublikationsliste

Karin Heinschink: Wäre es leicht umzusetzen, dass man bei der Liste der Publikationen in der Projektbeschreibung das Publikationsdatum (oder den Publikationstyp) anzeigt? Dann sieht man gleich, was das aktuellste Dokument ist bzw. haben manchmal die Beiträge den gleichen Titel, werden aber bei unterschiedlichen Veranstaltungen präsentiert. Oder es gibt einen Beitrag bei einer Veranstaltung, aber mehrere Dateien dazu (z.B. Foliensatz, Abstract oder Beitrag im Tagungsband). 

Ich habe die Liste der Publikationen auf der Projektdetailseite geändert, um dieses Problem zu beheben.
Die Liste ist jetzt nach Publikationstypen unterteilt und enthält Indikatoren für den Status „im Projekt verfügbar“ und „auf der Website“ der Publikationen sowie das Veröffentlichungsdatum.

5. Publikationstyp auswahl

Ich habe die Auswahl der Publikationstypen komplett neu organisiert.
Zuvor gab es beim Filtern von Publikationen oder Auswählen des Publikationstyps zwei Auswahl-Dropdowns. Das erste diente zur Auswahl des Stammtyps und das zweite zur Auswahl des Untertyps aus dem Publikationstypenbaum.

Dies war nicht intuitiv und machte es schwierig, ohne vorherige Kenntnis des Typenbaums bestimmte Publikationstypen zu finden (z. B. Workshops, die unter der Stammkategorie „Organisatorische Tätigkeiten“ lagen).

Das neue Auswahlfeld für den Publikationstyp zeigt den gesamten Baum und ermöglicht die Anwendung eines Filters.

0.0.4 Versionshinweise 17.06.2025

Fehlerbehebungen

1. Projektnutzer laden aus D-ESS KS/KT/TÄ-Baum

Benutzer des D-ESS, die als Unterkostenträger buchbar waren, wurden beim Klicken auf die Schaltfläche „Benutzer hinzufügen“ nicht in die Liste der importierten Benutzer aus dem D-ESS aufgenommen. Die Schaltfläche

war deaktiviert, auch wenn Benutzer in der Liste fehlten.

 

2. Änderungen in der PDF-Dateibeschreibung

Beim Bearbeiten einer Publikation wurde die Beschreibung einer PDF-Datei nach der Änderung nicht korrekt gespeichert. Dies funktioniert jetzt wie erwartet.

Neue Funktionen

 

1. neue PDF-Dateieigenschaften in Publikation

Neue Einstellungen für PDF-Dateien in Publikationen hinzugefügt. Wie von Michael Kogler (Raumberg Gumpenstein) vorgeschlagen.

Das Kontrollkästchen „In Publikation“ bestimmt, ob die PDF-Datei in der Publikation sichtbar ist. Andernfalls ist die PDF-Datei nur für den Eigentümer sichtbar (privat).

Das Kontrollkästchen „Auf der Website“ bestimmt, ob die PDF-Datei auf der Website veröffentlicht wird. Projekt, Publikation und PDF müssen alle als „Auf der Website“ gekennzeichnet sein, bevor die PDF-Datei auf der Website veröffentlicht wird. Nur Benutzer mit der Berechtigung „Publikation auf der Website Kontrollkästchen ändern“ können diese Kontrollkästchen ändern.

Der Eigentümer ist zunächst die Person, die das PDF hochgeladen hat, aber kann von Administratoren mit der Systemberechtigung „Alle Projekte und Publikationen verwalten“ geändert werden.

2. neue Publikationstypeigenschaften

Es gibt zwölf neue Publikationseigenschaften, die für relevante Publikationstypen konfiguriert werden können. Zusätzlich gibt es ein neues Kontrollkästchen „Pflichtfeld“, mit dem sich das Verhalten des Eingabefelds auf den Seiten zum Hinzufügen und Bearbeiten von Publikationen ändern lässt.

Die vollständige Liste der verfügbaren Parameter in dieser Version lautet wie folgt:

Sprache
DOI
ISSN
ISBN
Art
Ort
Schule
Universität
Tage
Teilnehmer
Teilnehmer (10er Stufen)
Anzahl der Zuhörer
Name des Journals
Volume Nummer
Issue Nummer
Von Seite
Bis Seite
Stunden pro Kurs
ECTS pro Semester
Name der Person
Treffen pro Jahr
Dauer in Minuten

3. Autovervollständigung und Validierung von Publikationseigenschaften

Die Spracheingabe verfügt nun über eine Autovervollständigung und enthält die 70 meistgenutzten Sprachen der Welt, wobei Deutsch, Englisch und Französisch (die beliebtesten Wissenschaftssprachen) ganz oben auf der Liste stehen.

DOI-, ISSN- und ISBN-Eingabefelder werden auf gültige Codes überprüft, und alle Zahleneingaben werden nun auf Ganzzahlen oder reelle Zahlen überprüft.

4. Neue Website-Administratorberechtigungen

Die Systemberechtigungsgruppe verfügt jetzt über neue Berechtigungen im Zusammenhang mit der Website-Veröffentlichung.

Aus dem Feedback der internen BAB-Sitzung ging hervor, dass nur bestimmte autorisierte Benutzer den Status „Auf der Website“ ändern können sollten. Ich habe dies in zwei separate Berechtigungen aufgeteilt.

Nur Benutzer mit der Berechtigung „Projekt auf der Website Kontrollkästchen ändern“ können das Kontrollkästchen „Auf der Website“ im Projekt ändern.

Nur Benutzer mit der Berechtigung „Publikation auf der Website Kontrollkästchen ändern“ können das Kontrollkästchen „Auf der Website“ im Publikation oder in PDF datei ändern.

5. Neue config.js eigenschaften

Es gibt einen neuen Eintrag in der config.js, der bestimmt, ob die Autorenpunkte auf der Publikationstypseite angezeigt werden. Dienststellen, die diese Funktion benötigen, sollten diese Einstellung auf true setzen.

Systemadministration

Installieren und Konfigurieren von MongoDB

Befehlszeile für Debian:

apt update

apt-get install curl gnupg2 wget -y

curl -fsSL https://pgp.mongodb.com/server-7.0.asc | gpg -o /usr/share/keyrings/mongodb-server-7.0.gpg --dearmor

echo "deb [ signed-by=/usr/share/keyrings/mongodb-server-7.0.gpg ] http://repo.mongodb.org/apt/debian bullseye/mongodb-org/7.0 main" | tee /etc/apt/sources.list.d/mongodb-org-7.0.list

apt update

apt install mongodb-org -y

mongod --Version

systemctl start mongod

systemctl enable mongod

# create admin user
mongosh
    use admin
    db.createUser( {user: "admin", pwd: "xxxxxxxx", roles: [ { role: "userAdminAnyDatabase", db: "admin" } ] });
    exit;

# switch on authentication
vi /etc/mongod.conf

    security:
    authorization: "enabled"

    net:
    bindIp:192.168.xxx.xxx (or leave as 127.0.0.1 or hostname as required)

systemctl restart mongod
systemctl status mongod

# Optional: if Status is not running (error 14) it may be that you need to remove socket lock (permissions are now incorrect)
cd /tmp
rm -rf mongodb*.sock

# log in and create database user
mongosh "mongodb://admin:xxxxxxxx@192.168.xxx.xxx:27017/ddok" --authenticationDatabase admin
    db.createUser( {user: "ddok", pwd: "xxxxxxxx", roles: [ { role: "readWrite", db: "ddok" } ] })

node server config.js: