Goobi Administration Plugin for the periodic update of existing METS files with contents from a catalog query.
This documentation describes how to install, configure and use the Administration plugin to automatically repeat a catalog query to update records in Goobi workflow.
The Catalogue Poller plugin is automatically activated by Goobi. Its runtime starts at the configured start time and repeats according to the configured number of hours.
If, in addition to this automatic process, a user also wants access to the plugin's user interface, he or she must belong to a user group that has been granted the following plugin-specific right to do so:
In order to assign this right, the desired user group must first be assigned the right authorization in the right-hand area.
User group with assigned authorization
If the authorization for the user group is re-entered, the user must first log into Goobi again in order to be able to use this authorization level. The user can then click on the Catalogue Poller plugin in the Administration menu and manually trigger an update of the records at any time.
User interface of the Catalgue Pollers
Possibility to download the results of a test run
Downloaded Excel file
If the plugin finds updated metadata for a process and therefore updates the METS file, a backup of the current METS file
meta.xmland, if relevant, the
meta_anchor.xmlis created automatically. The backup is saved next to the updated METS file.
Multiple versions of METS files are kept as backups
The updates of the metadata by the plugin usually take place fully automatically in the background. In order to be able to track what happened to a data record at any time, the events are logged. Detailed entries are automatically added to the process log for each process for which there were changes from this plugin. In addition to the timestamp, these entries also contain an exact list of the changed metadata fields and their contents. Thus, it is possible to trace the previous or the new value at any time.
Within the process log the changes of the Catalogue Poller are traceable
The plugin consists of the following files to install:
These files must be installed in the correct directories so that they are available in the following paths after the installation:
There is also a configuration file, which must be located at the following location:
The plugin is configured via the configuration file
plugin_intranda_administration_catalogue_poller.xmland can be adapted during operation. The following is an example configuration file:
<?xml version="1.0" encoding="UTF-8"?>
<!-- multiple different rules can be defined for individual use cases -->
<rule title="SampleProject" startTime="22:00:00" delay="24">
<!-- filter which items to run through (can be more then one, otherwise use *)
please notice that blanks inside of the filter query need to be surrounded by quotation marks -->
<!-- which catalogue to use (GBV, Wiener, CBL Adlib ...) -->
<!-- which catalogue field to use and which identifier to use for the catalogue request (use
standard variable replacer compatible value here) -->
<catalogueField fieldName="12" fieldValue="$(meta.CatalogIDDigital)" />
<!-- define if existing structure subelements shall be kept (true),
otherwise a complete new mets file is created and overwrites the
existing one (false) -->
<!-- define if children shall be analysed as well. If a sub element contains an identifier, the metadata will get imported as well -->
<!-- execute an automatic export of updated records;
this is only executed if mergeRecords is set to true -->
<!--fieldList: Must have a mode attribute which can contain either blacklist or whitelist as a value.
blacklist: All fields are updated except the defined ones. This is a potentially dangerous setting!
whitelist: Only the definied fields are updated. All others are skipped.
field: Use the internal metadata names from the ruleset as field definition
<!-- internal timestamp for the plugin to know when it was last executed -->