Project export as folder with images and Excel file
This workflow plugin allows an export of an entire project into a directory structure with an Excel file and the associated images according to specific project specifications

Introduction

This workflow plugin allows a very specific export of an entire project. For this purpose, the plugin first checks whether the configured step in the workflow has actually been completed in all processes of the selected project. Depending on this check, the plugin then allows an export of all images of a defined image directory (e.g. the master images) and an export of defined metadata within an Excel file. The structure of the Excel file is such that the respective metadata is redundantly listed in a separate line for each image.
If the initial check determines that the configured workflow step in the workflow has already been completed for all processes of the project, the configured export workflow step is also set to completed for all processes of the project.

Overview

Details
Text
Identifier
intranda_workflow_projectexport
Licence
GPL 2.0 or newer
Compatibility
Goobi workflow 20.11
Documentation date
20.12.2020

Installation

To install the plugin, the following two files must be installed:
1
/opt/digiverso/goobi/plugins/workflow/plugin_intranda_workflow_projectexport.jar
2
/opt/digiverso/goobi/plugins/GUI/plugin_intranda_workflow_projectexport-GUI.jar
Copied!
To configure how the plugin should behave, various values can be adjusted in the configuration file. The configuration file is usually located here:
1
/opt/digiverso/goobi/config/plugin_intranda_workflow_projectexport.xml
Copied!
The content of this configuration file looks like this:
1
<config_plugin>
2
3
<config>
4
<!-- name of the project, can be repeated. Use * for any project -->
5
<project>*</project>
6
<!-- check if all proceses of the project have finished this task -->
7
<finishedStepName>Metadata enrichment</finishedStepName>
8
<!-- close this step after the export was successful -->
9
<closeStepName>Export</closeStepName>
10
<!-- define which image folder (master|media|jpeg|source|...) shall be used for the export -->
11
<imageFolder>media</imageFolder>
12
<!-- write the export into this directory -->
13
<exportDirectory>/opt/digiverso/viewer/hotfolder</exportDirectory>
14
<!-- define if the export result shall be provided as zip file download -->
15
<allowZipDownload>true</allowZipDownload>
16
</config>
17
18
</config_plugin>
Copied!
To use this plugin, the user must have the correct role authorisation.
Without correct authorisation the plugin cannot be used
Therefore, please assign the role Plugin_Goobi_ProjectExport to the group.
Correctly assigned role for the users

Explanation of the configuration options

The configuration of the plug-in is as follows:
Value
Description
config
The block config can occur any number of times. This allows several individual settings to be made for individual projects.
project
Use this parameter to define for which project the configuration should take effect. The names of the projects can be listed here in a repeatable manner.
finishedStepName
This parameter is used to define which workflow step is to be completed for all tasks of the selected project so that the export workflow step is also marked as completed for all processes of the project after the export has been carried out.
closeStepName
Here you can specify the name of the workflow step that is closed after the export has been carried out.
imageFolder
Specify here which directory is to be used for the export. Typical values for this are master or media.
exportDirectory
A target directory for the export can be specified for each configuration block. All exports will take place within the folder specified here.
allowZipDownload
If, in addition to exporting to the configured directory, it should also be possible to download the entire export as a zip file, this can be activated here.

Operation of the plug-in

If the plugin has been installed and configured correctly, it can be found within the menu item Workflow and can be started from there. If you have the necessary rights to use the plugin, you can now select from the available projects.
Selection of the project
After selecting the desired project, two buttons are available depending on the configuration. These allow either the execution of the export into the desired target directory or the download of the entire export result as a large zip file.
Structure of the directory after executing the export
The export result is structured in such a way that for each process a subfolder is created within which the corresponding images from the defined directory are located. In addition, an Excel file is created.
Structure of an exported Excel file with all associated metadata per image
Within each line of this Excel file there is now the respective metadata that was read from the METS file, whereby these are listed redundantly for each image repeatedly.