Vokabularanreicherung

Step Plugin für die automatische Anreicherung von Vokabularen

Übersicht

Name	Wert

Einführung

Diese Dokumentation bietet einen kurzen Überblick über dieses Plugin, das verwendet wird, um Vokabulare basierend auf Metadaten, die in METS-MODS-Dateien innerhalb von Goobi-Workflows gefunden werden, anzureichern.

Installation

Um das Plugin nutzen zu können, müssen folgende Dateien installiert werden:

/opt/digiverso/goobi/plugins/step/plugin_intranda_step_vocabulary_enrichment.jar
/opt/digiverso/goobi/config/plugin_intranda_step_vocabulary_enrichment.xml

Sobald das Plugin installiert ist, kann es innerhalb des Workflows für die jeweiligen Arbeitsschritte ausgewählt und somit automatisch ausgeführt werden.

Überblick und Funktionalität

Das Programm untersucht die Metadatenfelder einer METS-MODS-Datei aus einem Goobi-Prozess. Für jedes in der Konfigurationsdatei definierte <item> durchsucht das Plugin die METS-MODS-Datei nach den angegebenen Metadaten. Die Suche kann auf die oberste Struktur eines Dokuments beschränkt werden, indem die Form meta.topstruct.metadataName verwendet wird. Wenn ein oder mehrere Metadaten gefunden werden, wird das benannte Vokabular durchsucht. Wenn das Vokabular keinen Eintrag mit dem im target-Feld spezifizierten Wert enthält, der mit dem Wert der gefundenen Metadaten übereinstimmt, wird ein neuer Vokabulareintrag erstellt, bei dem das target-Feld den Wert der gefundenen Metadaten erhält. Wenn es generate-Felder im <item> gibt, werden die Felder des neuen Vokabulareintrags, die dort angegeben sind, mit den im content-Attribut definierten Werten versehen.

Konfiguration

Das Plugin wird in der Datei plugin_intranda_step_vocabulary_enrichment.xml wie folgt konfiguriert:

<config_plugin>
    <!-- order of configuration is: 1.) project name and step name matches 2.) step name matches and project is * 3.) project name matches and step name is 
        * 4.) project name and step name are * -->

    <config>
        <!-- which projects to use for (can be more then one, otherwise use *) -->
        <project>*</project>
        <step>*</step>

        <item>
            <source>meta.originalAccessPersons</source>
            <vocabulary>Access points</vocabulary>
            <target>original value</target>
            <generate field="type" content="AccessPersons" />
            <generate field="authority" content="viaf" />
            <generate field="authorityURI" content="https://viaf.org/" />
        </item>
        <item>
            <source>meta.originalAccessCorporate</source>
            <vocabulary>Access points</vocabulary>
            <target>original value</target>
            <generate field="type" content="AccessCorporate" />
            <generate field="authority" content="viaf" />
            <generate field="authorityURI" content="https://viaf.org/" />
        </item>
        <item>
            <source>meta.originalAccessLocations</source>
            <vocabulary>Access points</vocabulary>
            <target>original value</target>
            <generate field="type" content="AccessLocations" />
            <generate field="authority" content="geonames" />
            <generate field="authorityURI" content="http://www.geonames.org/" />
        </item>
        <item>
            <source>meta.originalAccessSubject</source>
            <vocabulary>Access points</vocabulary>
            <target>original value</target>
            <generate field="type" content="AccessSubject" />
            <generate field="authority" content="geonames" />
            <generate field="authorityURI" content="http://www.geonames.org/" />
        </item>
    </config>

</config_plugin>

Allgemeine Parameter

Der Block <config> kann für verschiedene Projekte oder Arbeitsschritte wiederholt vorkommen, um innerhalb verschiedener Workflows unterschiedliche Aktionen durchführen zu können. Die weiteren Parameter innerhalb dieser Konfigurationsdatei haben folgende Bedeutungen:

Parameter	Erläuterung

Weitere Parameter

Neben diesen allgemeinen Parametern stehen die folgenden Parameter für die weitergehende Konfiguration zur Verfügung:

Parameter	Erklärung