Batch Progress Plugin
This Step Plugin for Goobi workflow allows to let all processes of one batch come to the same progress to trigger some REST call and let all processes move on their work again in parallel.
Overview
Introduction
This step plugin for Goobi workflow allows multiple Goobi processes that belong to a batch but have different progress in their workflows to all wait for each other at a defined workflow step. Only when the last associated process reaches the defined workflow step does a call to a specified REST URL take place, so that all processes can then continue with their respective next workflow steps.
The initial purpose of this plugin is to call AEON REST URLs to log the progress of Goobi workflows. Other uses for this plugin are possible, but may require customisation of the plugin.
Installation
The plugin consists in total 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:
Overview and functionality
To put the plugin into operation, it must be activated for one or more desired tasks in the workflow. This is done as shown in the following screenshot by selecting the plugin intranda_step_batch_progress
from the list of installed plugins.
Since this plugin should usually be executed automatically, the workflow step should be configured as automatic
.
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, calling the plugin through the workflow in the background does the following:
First, it is checked whether the process belongs to a batch. If this is not the case, the workflow step is closed and the further workflow is started.
Otherwise, it is checked whether the current workflow step has already been reached in all processes of the batch (the status must not be Locked
). If this is not yet the case, the step remains in the status In Work
.
However, if all other processes in the batch have reached the workflow step or there is only the current process in the batch, a new status is set in AEON if this has been activated with the parameter updateQueue
. To do this, a search is made in the properties of the process for the transaction identifier
property with which the processes were initially created. This record is then called up in AEON to set the configured queueName
as the new status.
The current workflow step in all processes of the batch is then closed and the rest of the workflow continues.
Configuration
The plugin is configured via the configuration file plugin_intranda_step_batch_progress.xml
and can be adapted during operation. The following is an example configuration file:
Various parameters can be configured within the configuration file. The file is divided into two areas. In the <global>
area, generally valid information such as the access data to AEON is managed. The following parameters are available here:
In addition, there is the second area <config>
, in which different specifications can be made for individual workflow steps. Here it can be specified for individual projects and steps into which queue the data set is to be written.
The block <config>
can be repeated for different projects or workflow steps in order to be able to carry out different actions within different workflows and also to be able to set a different status in AEON for different steps. The other parameters within this configuration file have the following meanings:
Last updated