Konfigurationseditor

Dies ist ein Administration Plugin für den Goobi workflow, mit dem Sie lesend und schreibend auf alle wichtigen Konfigurationsdateien des Goobi-Workflows zugreifen können, die sich normalerweise im Or

Einführung
Dieses Plugin dient zur direkten Bearbeitung der verschiedenen Konfigurationsdateien von Goobi workflow direkt aus der Benutzeroberfläche innerhalb des Webbrowsers.
Übersicht
Details
Erläuterung
Identifier
intranda_administration_config_file_editor
Source code
​https://github.com/intranda/goobi-plugin-administration-config-file-editor​
Lizenz
GPL 2.0 oder neuer
Dokumentationsdatum
06.11.2021
Arbeitsweise des Plugins
Nach der Installation ist das Plugin in einem eigenen Eintrag im Menü Administration zu finden, von wo es geöffnet werden kann.
Geöffnetes Plugin ohne geladene Datei
Nach dem Öffnen werden auf der linken Seite alle Konfigurationsdateien von Goobi aufgelistet. Diese kann man durch Anklicken des jeweiligen Icons öffnen, um sie zu bearbeiten.
Geöffnetes Plugin mit geladener Datei
Öffnet man eine Datei, erscheint auf der rechten Seite ein Texteditor, in dem die Datei bearbeitet werden kann. Bearbeitet und speichert man eine Datei, wird im definierten Backupverzeichnis automatisch ein Backup angelegt.
Gespeicherte Datei
Entsprechend des eingestellten Wertes in der Konfigurationsdatei bleibt hier eine gewisse Anzahl an älteren Backups erhalten, bevor diese durch neuere ersetzt werden.
Dateien innerhalb des Backup-Verzeichnisses
Wurde eine Datei verändert und wird ohne zuvor zu speichern ein Wechsel zu einer anderen Datei versucht, bekommt der Beareiter eine Rückfrage, wie mit den Änderungen zu verfahren ist.
Nachfrage bei ungespeicherten Daten
Innerhalb von Goobi können für Konfigurationsdateien Hilfetexte definiert werden, die für die Bearbeitung in diesem Editor behilflich sein können. Die hinterlegten Hilfetexte werden dabei abhängig von der derzeit geöffneten Datei im linken Bereich angezeigt und verfügen auch über die Möglichkeit, dass hier mit Formatierungen gearbeitet wird.
Hilfetexte für die jeweiligen Konfigurationsdateien
Installation
Das Plugin besteht insgesamt aus den folgenden zu installierenden Dateien:
1
plugin_intranda_administration_config_file_editor.jar
2
plugin_intranda_administration_config_file_editor-GUI.jar
3
plugin_intranda_administration_config_file_editor.xml
Copied!
Diese Dateien müssen in den richtigen Verzeichnissen installiert werden, so dass diese nach der Installation unter den folgenden Pfaden vorliegen:
1
/opt/digiverso/goobi/plugins/administration/plugin_intranda_administration_config_file_editor.jar
2
/opt/digiverso/goobi/plugins/GUI/plugin_intranda_administration_config_file_editor-GUI.jar
3
/opt/digiverso/goobi/config/plugin_intranda_administration_config_file_editor.xml
Copied!
Konfiguration
Die Konfiguration des Plugins erfolgt über die Konfigurationsdatei plugin_intranda_administration_config_file_editor.xml und kann im laufenden Betrieb angepasst werden. Im folgenden ist eine beispielhafte Konfigurationsdatei aufgeführt:
1
<config_plugin>
2
​
3
	<configFileDirectory>/opt/digiverso/goobi/config/</configFileDirectory>
4
	<!-- By editing a config file in the browser GUI, a backup file will be stored in the backup directory -->
5
	<configFileBackupDirectory>/opt/digiverso/goobi/config/backup/</configFileBackupDirectory>
6
	<!-- backup files will be stored as config.xml.1, config.xml.2, ..., config.xml.n -->
7
	<numberOfBackupFiles>8</numberOfBackupFiles>
8
​
9
</config_plugin>
Copied!
Die Parameter innerhalb dieser Konfigurationsdatei haben folgende Bedeutungen:
Parameter
Erläuterung
configFileDirectory
Dies ist der Pfad, an dem sich die Konfigurationsdateien befinden.
configFileBackupDirectory
Hiermit wird der Pfad für die Backup-Dateien festgelegt, wo nach dem Bearbeiten die Backups der Konfigurationsdateien gespeichert werden sollen.
numberOfBackupFiles
Dieser ganzzahlige Wert gibt an, wie viele Backup-Dateien pro Konfigurationsdatei gespeichert bleiben, bevor sie durch neue Backups überschrieben werden.
Sollen Hilfetexte zu einzelnen Konfigurationsdateien angezeigt werden, so müssen diese innerhalb der messages-Dateien hinterlegt werden. Hierzu wird beispielsweise in diesen Dateien eine Anpassung vorgenommen:
1
/opt/digiverso/goobi/config/messages_de.properties
2
/opt/digiverso/goobi/config/messages_en.properties
Copied!
Für jede Konfigurationsdatei kann dort in der jeweiligen Datei ein Wert wie die folgenden eingetragen werden.
Deutsche Fassung innerhalb der Datei messages_de.properties:
1
plugin_administration_config_file_editor_help_goobi_projects.xml = Dies ist ein Hilfetext für die Konfiguration der Anlegemaske. <br/>Hier kann eine <i>Beschreibung</i>, die <b>formatiert</b> ist.<br/><br/><pre>Und auch Quellcode kann hier stehen</pre>
Copied!
Englische Fassung innerhalb der Datei messages_en.properties:
1
plugin_administration_config_file_editor_help_goobi_projects.xml = This is a help text for the creation mask. <br/>You can add a <i>Description</i> here, which is <b>formatted</b>.<br/><br/><pre>And you can put source code here as well</pre>
Copied!
Zu beachten ist hierbei, dass jeweils der Präfix plugin_administration_config_file_editor_help_ vor dem Namen der Konfigurationsdatei angefügt wird.
Einrichtung benötigter Berechtigungen
Dieses Plugin verfügt über eine eigene Berechtigungsstufe für die Verwendung. Aus diesem Grund müssen Nutzer über die erforderlichen Rechte verfügen.
Kein Zugriff ohne korrekte Rechte
Bitte weisen Sie daher der Benutzergruppe der entsprechenden Nutzer das folgende Recht zu:
1
Plugin_administration_config_file_editor
Copied!
Korrekt zugewiesenes Recht für die Nutzer