This documentation describes how to install, configure and use a plug-in to upload documents to Goobi. With the help of this plug-in, born-digital documents such as PDF files can be uploaded and managed directly in Goobi.
- Source code not yet publicly available -
Goobi workflow 2.1
The precondition for using the plugin is the use of Goobi 2.1, the use of the new Goobi interface, the subsequent correct installation and configuration of the plugin as well as the correct integration of the plugin into the desired steps of the workflows.
The following three files must be installed to use the plugin:
The first file contains the actual program logic, the second file provides the graphical user interface for the display and the third file is used to configure the plugin.
The content of the configuration file
plugin_PdfUploadPlugin.xml must be structured as follows:
<config_plugin><!-- allowed values: master, source, derivate --><folder>derivate</folder><extensions><extension>pdf</extension><extension>PDF</extension></extensions></config_plugin>
folder specifies the folder in which the uploaded files are stored. The values
derivate can be used. Afterwards the allowed file extensions have to be configured. Please make sure that the check is case sensitive. If you want to allow upper and lower case, both spellings must be defined.
Then the allowed file extensions have to be configured. Here you have to make sure that the check is case sensitive. If you want to allow upper and lower case, both spellings must be defined.
Once the plugin has been installed and configured, it can be used within Goobi's new user interface.
To do this, the plugin for the
intranda_step_pdfUpload step must be entered within the desired task.
If the corresponding step has been opened by the respective user within which the plugin was configured, a new area for uploading files is available.
Select file button, you can now select a file which is then transferred to the server using the
Upload file button. You can optionally enter a comment.
The uploaded file is then listed with some information. There you can also delete the file.
Only files whose file extension was previously entered in the list of permitted extensions are accepted. In addition, the file name may only consist of the characters
Spaces are automatically replaced by
If a file is uploaded, the information is stored in the METS file.
<mets:fileGrp USE="LOCAL"><mets:file ID="FILE_0001" MIMETYPE=""><mets:FLocat LOCTYPE="URL"xlink:href="/opt/digiverso/goobi/metadata/6212/images/myFolder/AC03719978.pdf"xmlns:xlink="http://www.w3.org/1999/xlink" /></mets:file></mets:fileGrp>[...]<mets:structMap TYPE="PHYSICAL"><mets:div DMDID="DMDPHYS_0000" ID="PHYS_0000" TYPE="BoundBook"><mets:div ID="PHYS_0001" ORDER="1" TYPE="page" ORDERLABEL="Kommentar"><mets:fptr FILEID="FILE_0001" /></mets:div></mets:div></mets:structMap>
The transfer to the METS file ensures that the order of the uploaded files is saved persistently.
If the task is then opened again, the information about the uploaded files is taken from the METS file and also displayed.