1.1 Lokale Einstellungen

Das Semikolon ist in der Konfigurationsdatei ein reserviertes Delimiter-Zeichen und muss gegebenenfalls explizit mit einem Backslash maskiert werden!

Im lokalen Konfigurationsordner können folgende Dateien angelegt werden:

• config_viewer.xml (Hauptkonfigurationsdatei des Goobi viewer)

• config_imageFooter.xml (Konfigurationsdatei für den Image footer)

• config_pdfTitlePage.xml (Konfigurationsdatei für die PDF Titelseite)

Jedes Konfigurationselement in der globalen Konfigurationsdatei config_viewer.xml (auf einem Ubuntu System zum Beispiel unter /var/lib/tomcat9/webapps/viewer/WEB-INF/classes/ zu finden) kann mit einer benutzerdefinierten Konfiguration in der lokalen config_viewer.xml überschrieben werden, mit Ausnahme des Parameters configFolder.

Ab der Version 22.11 des Goobi viewers kann der configFolder über eine Java Variable übergeben werden. Das kann nützlich sein, wenn mehrere Goobi viewer Instanzen auf einem Server installiert sind und ansonsten bei jedem Update in der globalen Konfigurationsdatei der Standardpfad zum lokalen configFolder angepasst werden muss. Die Einstellung kann zum Beispiel in der /etc/default/tomcat9 erfolgen:

JAVA_OPTS="${JAVA_OPTS} -DconfigFolder=/path/to/second/viewer/config/" 

Zum Beispiel existiert folgendes Konfigurationselement in der globalen Konfigurationsdatei config_viewer.xml:

config_viewer.xml

<collections>
    <redirectToWork>true</redirectToWork>
</collections>

Der folgende Eintrag in der lokalen Konfigurationsdatei config_viewer.xml wird den gleichnamigen Eintrag der globalen Konfigurationsdatei überschreiben und somit die automatische Weiterleitung zum Werk wenn eine Sammlung nur ein Werk enthält deaktivieren:

config_viewer.xml

 <collections>
    <redirectToWork>false</redirectToWork>
</collections>

Dabei genügt es, nur die Elemente in die lokale Konfigurationsdatei einzufügen, die vom Standardwert der globalen Konfigurationsdatei abweichen sollen und daher überschrieben werden sollen. Alle anderen Elemente werden weiterhin aus der Standard-Konfigurationsdatei gelesen.

Zusätzlich zu einzelnen Konfigurationseinstellungen können ganze Listen von Einträgen überschrieben werden.

Ein Beispiel sind Listen von Metadatentypen, die angezeigt werden sollen:

config_viewer.xml

<metadata>
    <metadataView index="0">
        <template name="_DEFAULT">
            <metadata label="MD_TITLE" value="">
                <param type="field" key="MD_TITLE" />
            </metadata>
            <metadata label="MD_SHELFMARK" value="">
                <param type="field" key="MD_SHELFMARK" />
            </metadata>
        </template>
    </metadataView>
</metadata>

Das obige Beispiel ersetzt den kompletten Block <metadataView index="0"> in der Standard-Konfigurationsdatei.