AEON data transfer
This workflow plugin enables Goobi processes to be created on the basis of an initial AEON request. Among other things, it enables manual selection of elements from the AEON response.
Overview
Identifier
intranda_workflow_aeon_process_creation
Licence
GPL 2.0 or newer
Last change
07.09.2024 08:54:29
Introduction
This plugin can be used to query individual data sets from AEON. After a record has been queried, all metadata from the so-called Metadata Cloud are retrieved and listed. The user can then select which data sets he or she would like to create as a Goobi operation.
Installation
The plug-in consists of the following files to be installed:
These files must be installed in the correct directories so that they are available under the following paths after installation:
This plugin has its own permission level for use. For this reason, users must have the required permissions. Therefore, please assign the following right to the user group of the corresponding users:
Overview and functionality
If the user has the authorisation to use the plugin, the plugin AEON Query Plugin
can be opened in the menu item Worklow
.
A transaction identifier can now be entered here to start the search for an AEON record.
If a successful search was performed, the query details
area was filled with the fields that were defined within the configuration in the <transaction>
area. In the area Properties for all transactions
the freely definable properties from the configuration area <properties>
are displayed.
These fields can be edited if this has been provided for in the configuration file. Violations of the validation are displayed directly next to the individual fields.
In the right-hand area of the user interface, the individual data records found within the Metadata Cloud for the barcode of the AEON record are listed. Each box represents an independent data record. More details of a data record can be displayed by expanding further fields of the boxes. The corresponding icons per box can be used to select the data sets for which processes are to be generated in Goobi.
Provided at least one record has been selected and there are no unfulfilled strict validations, clicking on the Create processes
button allows the user to create the individual Goobi processes for the selected records based on the configured process template. This then takes the user to another view.
The left-hand pane lists the records for which processes have been created in Goobi. The right-hand pane offers the option of generating and downloading a docket for all created processes, where the associated processes are all listed together within a common batch.
Configuration
The plugin is configured via the configuration file plugin_intranda_workflow_aeon_process_creation.xml
and can be adapted during operation. The following is an example configuration file:
The access data is managed within the <aeon>
area. The URL to the RESTful API of AEON as well as the user name and password must be stored here. If, alternatively, a key is to be used for the use of the API, this must be specified.
In the block <processCreation>
it can be defined which OPAC configuration is to be used to request catalogue data and on the basis of which production template the individual processes are to be created.
This is followed by the configuration of the fields that are displayed and can be imported. This is divided into 3 areas. The area <transaction>
contains those fields that are read from the AEON record. The area <properties>
contains freely definable properties that belong to the transactions to be created. And the area <processes>
contains the fields that were obtained from the Metadata Cloud when querying the data.
The configuration within the three areas is almost identical. Each field is defined by a <field>
element. Within this, the following options are subsequently provided:
title
display name of the field
type
Type of field, possible values are input
(text field), select
(selection field), vocabulary
(selection field from a vocabulary), checkbox
(checkbox), input-dont-overwrite
(text field editable on the left but not on the right),radio-dont-overwrite
(radio buttons editable in the left area but not in the right area).
readonly
The values true
or false
define whether the content of the field may be edited.
aeon
Name of the json element from which the field is filled. This parameter is not evaluated for the freely definable properties.
displayAlways
The values true
or false
define whether the field is displayed when only a minimised record is displayed. This parameter is only evaluated for the fields from the Metadata Cloud.
displayInTitle
The values true
or false
define whether the field is listed within the header of the box. This parameter is only evaluated for the fields from the Metadata Cloud.
variable
This parameter defines the name of the property to be created. This parameter is not evaluated for data from the Metadata Cloud.
place
This parameter defines the type of the property. Possible values are work
(workpiece property), process
(process property), template
(template property).
value
This parameter can be used to set a default value. If an AEON element is configured and obtained by the query, the configured default value is overwritten with the content from AEON.
help
This parameter can be used to define a help text that can optionally be displayed.
validation
This parameter defines a regular expression against which the field content can be validated.
strict
The values true
or false
define whether a validation violation must be resolved before operations can be created.
message
This parameter specifies a message to be displayed in case of validation errors.
vocabularyName
This parameter defines a vocabulary to be used.
vocabularyField
The parameter fieldname=value
can be used to restrict the hit set to values that meet this definition. The field is repeatable to define several restrictions at the same time.
Last updated