D-DOK Forschungsdokumentation
D-DOK ist eine Software zur Speicherung von Details zu Forschungsprojekten und zugehörigen Dokumenten staging-ddok.agrarforschung.at
- 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.
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.
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.
Neue Funktionen
1. neue PDF-Dateieigenschaften in Publikation
Neue Einstellungen für PDF-Dateien in Veröffentlichungen hinzugefügt. Wie von Michael Kogler (Raumberg Gumpenstein) vorgeschlagen.
Das Kontrollkästchen „In Veröffentlichung“ bestimmt, ob die PDF-Datei in der Veröffentlichung sichtbar ist. Andernfalls ist die PDF-Datei nur für den Eigentümer (privat) sichtbar.
Das Kontrollkästchen „Auf der Website“ bestimmt, ob die PDF-Datei auf der Website veröffentlicht wird. Projekt, Veröffentlichung und PDF müssen alle als „Auf der Website“ gekennzeichnet sein, bevor die PDF-Datei auf der Website veröffentlicht wird.
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 Publikationstyp Eigenschaften
Es gibt neun 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.
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.
Nur Benutzer mit der Berechtigung „On Website Kontrollkästchen ändern“ können das Kontrollkästchen „On Website“ im Projekt, in der Publikation oder in der PDF-Datei ändern.
Die zweite Berechtigung „Website veröffentlichen“ dient der zukünftigen Erweiterung und ermöglicht dem Nutzer die Erstellung der Website-Datenbank.
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.101.120 (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.101.120:27017/ddok" --authenticationDatabase admin
db.createUser( {user: "ddok", pwd: "xxxxxxxx", roles: [ { role: "readWrite", db: "ddok" } ] })