Goobi workflow Plugins (English)
Search…
Administration Plugins
Step Plugins
Opac Plugins
Import Plugins
Export Plugins
Workflow plugins
Statistics
Extraction of image metadata
This Step Plugin allows the extraction of metadata from image files in order to store them within the METS files.
Introduction
With the help of this plugin, metadata can be extracted from image files and stored within Goobi's METS files. Here, a use of the Linux programme ExifTool takes place in the background in order to transfer its read image metadata according to individual configuration.
Overview
Details
Text
Identifier
intranda_step_imageMetadataExtraction
Licence
GPL 2.0 or newer
Compatibility
Goobi workflow 2020.12
Documentation date
02.04.2021
Installation
To install the plugin, the following file must be installed:
1
/opt/digiverso/goobi/plugins/step/plugin_intranda_step_imageMetadataExtraction.jar
Copied!
To configure how the plugin should behave, various parameters can be adjusted within the configuration file. The configuration file is usually located under the following path:
1
/opt/digiverso/goobi/config/plugin_intranda_step_imageMetadataExtraction.xml
Copied!
Configuration of the plugin
The configuration of the plugin is structured as follows:
1
<config_plugin>
2
​
3
<config>
4
<!-- which projects to use for (can be more then one, otherwise use *) -->
5
<project>*</project>
6
<step>*</step>
7
​
8
<command>/usr/bin/exiftool</command>
9
<field line="Object Name" metadata="TitleDocMain" />
10
<field line="Keywords" metadata="SubjectTopic" />
11
<field line="Special Instructions" metadata="Footnote" />
12
<field line="City" metadata="PlaceOfPublication" />
13
<field line="Source" metadata="singleDigCollection" />
14
<field line="Copyright Notice" metadata="AccessCondition" />
15
<field line="Caption-Abstract" metadata="Abstract" />
16
</config>
17
​
18
</config_plugin>
Copied!
The block
<config> can occur repeatedly for different projects or workflow steps in order to be able to perform different actions within different workflows. The other parameters within this configuration file have the following meanings:Value
Description
projectThis parameter determines for which project the current block
<config> should apply. The name of the project is used here. This parameter can occur several times per <config> block.stepThis parameter controls for which workflow steps the block
<config> should apply. The name of the work step is used here. This parameter can occur several times per <config> block.commandWithin this parameter, the path to the programme 'ExifTool' is specified. This is a programme installed on the server that can read the metadata from image files.
fieldFor each desired metadata to be read out per image, a
field can be given in each case, consisting of the attributes line and metadata.The definition of fields is done with the following parameters:
Value
Description
lineThis parameter defines the name of the metadata within the result of ExifTool. Enter here accordingly the name how the metadata is present within the image.
metadataThis parameter determines under which metadata type the content of the read metatum is stored in the METS file. The internal name of the metadata type as defined in the corresponding rule set is used. It should be noted here that the metadata are always stored at the level of the highest logical structural element (e.g. a monograph) and not at subordinate logical or physical elements.
Integration into the workflow
To put the plugin into operation, it must be activated in a task in the workflow. This is done by selecting the plugin
intranda_step_imageMetadataExtraction from the list of installed plugins. Since the plugin relies on a METS/MODS file, the step should take place after the metadata edition.
Assigning the plugin to a specific task
How the plugin works
Once the plugin has been fully installed and set up, it is usually run automatically within the workflow, so there is no manual interaction with the user. Instead, the workflow calls the plugin in the background and automatically performs the extraction of the image metadata. This is done by opening the first image file from the media directory of the Goobi process, reading its metadata and storing it on the top logical level of the METS file as the configured metadata.