HERIS Vocabulary Update
Plugin for Automatic Update of the HERIS Vocabulary
Overview
Introduction
This documentation describes the installation, configuration, and usage of the plugin for the automatic, regular update of the HERIS vocabulary.
Installation
A prerequisite is Goobi version 23.03 or newer. Additionally, the following two files must be installed:
After installation, the functionality of the plugin is available within the REST API of Goobi workflow.
Overview and functionality
The import occurs regularly at the times specified in the goobi_config.properties
file. Alternatively, the import can also be manually triggered at any time. To do this, an administrator can open the Scheduled Tasks
section and execute the HERIS Import once.
When the plugin is executed, it connects to the SFTP server and searches for a JSON file. If multiple files exist, the file with the latest timestamp is used. The file is downloaded, opened, and the JSON array is split into individual objects. For each object, the identifier is searched and compared with existing records. If the identifier already exists in a record, the record is updated; otherwise, a new record is created.
Subsequently, the configured fields are iterated over, and the individual values are imported.
Finally, the downloaded file is deleted by the Goobi system. No data is changed on the SFTP system.
Configuration
The plugin is configured in the file plugin_intranda_quartz_heris.xml
as shown here:
The following table contains a summary of the parameters and their descriptions:
To ensure the update is automatically executed, the execution time must be configured in the goobi_config.properties
file. This is done by specifying the cron syntax for when it should run. For a daily execution at midnight, the following can be used:
Last updated