Goobi workflow Plugins (English)
Search…
Administration Plugins
Step Plugins
Opac Plugins
Import Plugins
Export Plugins
Workflow plugins
Statistics
Upload files
This step plugin allows the upload of different files within tasks in the web interface.
Introduction
This plugin is used to upload files within the user interface of an accepted task in Goobi workflow.
Overview
Details
Text
Identifier
intranda_step_fileUpload
Source code
Licence
GPL 2.0 or newer
Compatibility
Goobi workflow 2020.01
Documentation date
24.06.2020
Installation
To install the plugin the following two files must be installed:
1
/opt/digiverso/goobi/plugins/step/plugin_intranda_step_fileUpload.jar
2
/opt/digiverso/goobi/plugins/GUI/plugin_intranda_step_fileUpload-GUI.jar
Copied!
To configure how the plugin should behave, different values can be adjusted in the configuration file. The configuration file is usually located here:
1
/opt/digiverso/goobi/config/plugin_intranda_step_fileUpload.xml
Copied!
Configuration of the plugin
The configuration of the plugin is structured as follows:
1
<config_plugin>
2
​
3
<config>
4
<!-- which projects to use for (can be more than one, otherwise use *) -->
5
<project>*</project>
6
<step>*</step>
7
<!-- which file types to allow -->
8
<regex>/(\.|\/)(gif|jpe?g|png|tiff?|jp2|pdf)$/</regex>
9
<!-- which folder to use (master|main|jpeg|source|...) -->
10
<folder>master</folder>
11
</config>
12
​
13
<config>
14
<!-- which projects to use for (can be more than one, otherwise use *) -->
15
<project>My special project</project>
16
<project>Archive_Project</project>
17
<step>Upload derivatives</step>
18
<!-- which file types to allow -->
19
<regex>/(\.|\/)(gif|jpe?g|png|tiff?|jp2|pdf)$/</regex>
20
<folder>media</folder>
21
<folder>master</folder>
22
</config>
23
​
24
</config_plugin>
Copied!
The block
<config> can occur repeatedly for different projects or workflow steps in order to be able to perform different actions within different workflows. The other parameters within this configuration file have the following meanings:Value
Description
projectThis parameter determines the project for which the current block
<config> is to apply. The name of the project is used here. This parameter can occur several times per <config> block.stepThis parameter controls for which workflow steps the block
<config> is to apply. The name of the step is used here. This parameter can occur several times per <config> block.regexThis parameter can be used to specify which file types should be allowed for upload. In the above example, multiple image formats as well as pdf files are allowed.
folderWith this parameter you can define where the upload of the files should take place. This parameter can occur repeatedly and thus allows an upload to several directories, between which the user can then choose. Possible values for this are e.g.
master, media or also individual folders such as photos and scans.Integration of the plugin into the workflow
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
intranda_step_fileUpload plugin from the list of installed plugins.
Assigning the plugin to a specific task
Operation and use of the plugin
After the plugin has been completely installed and set up, it is available for the users of the corresponding tasks. After entering a task, it is now possible to upload files in the right area of the user interface.
Display of the upload area within the accepted task
Files can either be uploaded to this area by drag & drop or alternatively selected by clicking the button and thus uploaded.
If you want to check which files are already present in the folder after the upload, you can switch the display in the upper right area. This enables the user to list all files already existing in the folder, download individual files or delete them.
Display of an overview of all already existing files in the folder