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
​
Identifier
intranda_step_fileUpload
Source code
​https://github.com/intranda/goobi-plugin-step-fileupload​
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:
/opt/digiverso/goobi/plugins/step/plugin_intranda_step_fileUpload.jar
/opt/digiverso/goobi/plugins/GUI/plugin_intranda_step_fileUpload-GUI.jar
To configure how the plugin should behave, different values can be adjusted in the configuration file. The configuration file is usually located here:
/opt/digiverso/goobi/config/plugin_intranda_step_fileUpload.xml
Configuration of the plugin
The configuration of the plugin is structured as follows:
<config_plugin>
​
    <config>
        <!-- which projects to use for (can be more than one, otherwise use *) -->
        <project>*</project>
        <step>*</step>
        <!-- which file types to allow -->
        <regex>/(\.|\/)(gif|jpe?g|png|tiff?|jp2|pdf)$/</regex>
        <!-- which folder to use (master|main|jpeg|source|...) -->
        <folder>master</folder>
    </config>
​
    <config>
        <!-- which projects to use for (can be more than one, otherwise use *) -->
        <project>My special project</project>
        <project>Archive_Project</project>
        <step>Upload derivatives</step>
        <!-- which file types to allow -->
        <regex>/(\.|\/)(gif|jpe?g|png|tiff?|jp2|pdf)$/</regex>
        <folder>media</folder>
        <folder>master</folder>
    </config>
​
</config_plugin>
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
project
This 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.
step
This 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.
regex
This 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.
folder
With 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

Step Plugins - Previous

Replace images

Next - Step Plugins

Image scaling and watermarking

Last updated 2 months ago

Value	Description
`project`	This 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.
`step`	This 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.
`regex`	This 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.
`folder`	With 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`.

Details
Identifier	intranda_step_fileUpload
Source code	https://github.com/intranda/goobi-plugin-step-fileupload
Licence	GPL 2.0 or newer
Compatibility	Goobi workflow 2020.01
Documentation date	24.06.2020