This is the technical documentation for the Goobi plugin for integrating electronic publications.
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.
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.xmlmust be structured as follows:
<!-- allowed values: master, source, derivate -->
folderspecifies the folder in which the uploaded files are stored. The values
derivatecan 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_pdfUploadstep must be entered within the desired task.
Figure 1: Task-Details
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.
Figure 2: Upload-Plugin
Select filebutton, you can now select a file which is then transferred to the server using the
Upload filebutton. You can optionally enter a comment.
The uploaded file is then listed with some information. There you can also delete the file.
Figure 3: Uploaded files
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
Spacesare automatically replaced by
If a file is uploaded, the information is stored in the METS file.
<mets:file ID="FILE_0001" MIMETYPE="">
<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" />
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.