Step Plugin für die automatische Erstellung von Handle-IDs innerhalb von METS-Dateien
| Name | Wert |
|---|---|
Das Plugin erzeugt auf dem Handle-Server der GWDG einen Handle für alle logischen und physischen Elemente einer METS-Datei. Diese Handles werden dann in dem jeweiligen Element selbst als Metadatum _urn gespeichert.
Ist die automatische DOI-Vergabe installiert, so wird für jedes top-level logische Element ein neuer DOI erzeugt und gespeichert.
Um das Plugin nutzen zu können, müssen folgende Dateien installiert werden:
Die Datei goobi-plugin-step-handle-mets.jar enthält die Programmlogik und muss für den Tomcat-Nutzer lesbar in folgendes Verzeichnis installiert werden:
Die Datei plugin_intranda_step_handle_mets.xml muss ebenfalls für den Tomcat-Nutzer lesbar sein und in folgendes Verzeichnis installiert werden:
Nachdem das Plugin installiert und konfiguriert wurde, kann es innerhalb eines Arbeitsschrittes von Goobi genutzt werden. Dazu muss innerhalb der gewünschten Aufgabe das Plugin plugin_intranda_step_handle_mets eingetragen werden. Des Weiteren müssen die Checkboxen Metadaten und Automatische Aufgabe gesetzt sein.
Um die automatische DOI-Vergabe zu nutzen, muss eine zusätzliche Datei auf dem folgenden Pfad installiert werden, sodass sie für den Tomcat-Nutzer lesbar ist:
Diese Datei dient zur Konfiguration des Plugins und befindet sich im Ordner mappings.
Die Arbeitsweise des Plugins innerhalb des korrekt konfigurierten Workflows sieht folgendermaßen aus:
Wenn das Plugin innerhalb des Workflows aufgerufen wurde, öffnet es die METS-Datei.
Für jedes logische und physische Element der METS-Datei wird ein Handle erzeugt (in der Form /goobi-Institution-objektId, wobei die objektId diejenige der Objekt-Identifier, der ggf. mit dem Suffix -1, -2 etc. ergänzt wird, falls der Handle bereits existieren sollte).
Der generierte Handle wird dann in das jeweilige Strukturelement als der Metadatum vom Typ _urn geschrieben.
Beim Erzeugen der Handles für das oberste logische Strukturelement einer METS-Dateis, werden zusätzlich zu der generierten Handle-ID und der zugehörigen URL weitere Metadaten innerhalb des generierten Handles gespeichert. Das sieht dann beispielhaft wie folgt aus:
Diese Informationen werden im Falle der zusätzlichen DOI-Registriereung genutzt, um die DOI mit der gleichen ID zu erzeugen - in diesem Fall also 21.T119876543/goobi-go-1296243265-17.
Die Konfiguration des Plugins erfolgt in der Datei plugin_intranda_step_handle_mets.xml wie hier aufgezeigt:
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:
Neben diesen allgemeinen Parametern stehen die folgenden Parameter für die weitergehende Konfiguration zur Verfügung:
Die Datei plugin_intranda_step_handle_mets.xml muss für die DOI-Vergabe folgende zusätzlichen Konfigurationen beinhalten:
Der Parameter DOIMappingFile definiert dabei den Pfad zu der Datei plugin_intranda_step_handle_mets.xml.
In der DOI-Mapping.xml-Datei beschreibt jeder <map>-Eintrag eine Zuordnung (Mapping) zwischen einem Dublin-Core-Element und einem oder mehreren Metadatenfeldern aus der METS-Datei. Die Datei ist folgendermaßen aufgebaut:
| Parameter | Erläuterung |
|---|---|
| Parameter | Erläuterung |
|---|---|
| Parameter | Erläuterung |
|---|---|
Identifier
intranda_step_handle_mets
Repository
Lizenz
GPL 2.0 oder neuer
Letzte Änderung
26.08.2024 09:19:33
project
Dieser Parameter legt fest, für welches Projekt der aktuelle Block <config> gelten soll. Verwendet wird hierbei der Name des Projektes. Dieser Parameter kann mehrfach pro <config> Block vorkommen.
step
Dieser Parameter steuert, für welche Arbeitsschritte der Block <config> gelten soll. Verwendet wird hier der Name des Arbeitsschritts. Dieser Parameter kann mehrfach pro <config> Block vorkommen.
PEMFile
Pfad zur Private Key .PEM-Datei. Wird von der GWDG bereitgestellt.
HandleInstitutionAbbr
Kürzel für die Institution
HandleIdPrefix
Präfix für die Handles (z.B. für die Applikation oder das Projekt)
HandleBase
Identifier für die Institution
UserHandle
Identifier für den Nutzer der Handle-Registrierung
URLPrefix
URL, unter der die Dokumente mit ihrer Handle-ID zu finden sein werden nach Veröffentlichung.
<doiElt>
Ist das Dublin Core Element, für das dieser Mapping definiert ist
<localElt>
Ist der Name des Metadatums in der METS-Datei, dessen Wert für das <doiElt> verwendet werden soll
<altLocalElt>
Sind alternative Namen für das Metadatum, die durchsucht werden, falls kein Eintrag mit dem Namen <localElt> gefunden wird
<default>
Gibt den Wert an, der verwendet wird, falls weder <localElt> noch <altLocalElt> passende Einträge liefern.
<title>, <author>, <publisher>, <pubdate>, <inst>
Hierbei handelt es sich um die derzeit einzigen fünf notwendigen und zugleich maximal erlaubten Felder für Metadaten, die zur Registrierung verwendet werden.