Version: 7.2

Configuration

docuteam packer can be adjusted using several configuration files. The files are located at docuteam-packer/config.

docuteamPacker.properties
fileNameNormalizer.properties
charConversionMap.properties

If an adjustment has been made, a restart of docuteam packer is necessary for the changes to take effect. The file encoding should be ISO-8859-1.

docuteamPacker.properties

In the file docuteamPacker.properties basic adjustments can be made such as setting the language, view preferences, default folders or options for creating, delivering and saving SIP. All options as well as examples can be found as comments directly in the file.

The values true, false or en, de, fr are not case sensitive, i.e. true is identical to TRUE, True or even tRuE.

`docuteamPacker.displayLanguage`
Example	`en`
if empty or undefined	Language of the computer. If not set as `de`, `en` or `fr`, packer is displayed in German.
Explanation	The language in which packer is displayed. Currently there are three translations available (de = German, en = English, fr = French).

`docuteamPacker.dataDir`
Example	`C:/Data/RawData`
if empty or undefined	'Home' directory
Explanation	This folder is displayed by default to select files or folders to be included in the SIP.

`docuteamPacker.SIPDir`
Example	`C:/Data/SIPs`
if empty or undefined	'Home' directory
Explanation	This folder is displayed by default when a SIP is newly created, opened or saved.

`docuteamPacker.backupDir`
Example	`C:/Data/Backups`
if empty or undefined	Directory as defined in `SIPDir`.
Explanation	The folder where the automatic backups are stored.

`docuteamPacker.templateDir`
Example	`C:/Data/Templates`
if empty or undefined	Directory as defined in `SIPDir`.
Explanation	The folder in which the templates are stored.

`docuteamPacker.exportsDir`
Example	`C:/Data/Templates/exports`
if empty or undefined	Directory as defined in `SIPDir`.
Explanation	The folder in which the export templates are stored.

`docuteamPacker.reportsDir`
Example	`C:/Data/Templates/reports`
if empty or undefined	Directory as defined in `SIPDir`.
Explanation	The folder in which the report templates are stored.

`docuteamPacker.reportsDestinationDir`
Example	`C:/Data/Reports`
if empty or undefined	'Desktop'
Explanation	The folder in which the created reports are saved by default.

`docuteamPacker.tempDir`
Example	`C:/Data/Temp`
if empty or undefined	'Temp' directory
Explanation	Der Ordner für temporäre Dateien.

`docuteamPacker.lockFilesDir`
Example	`C:/Data/LockFiles`
if empty or undefined	The folder of the current SIP.
Explanation	Indicates the folder where lock-files are stored (indicating openend SIPs).

`docuteamPacker.AIPCreator.className`
Example	`ch.docuteam.darc.ingest.AIPCreatorBasic`
if empty or undefined	Creation of AIPs not possible.
Explanation	The name of the class that creates the AIP.

`AIPCreator.ingestSubmitDir`
Example	`C:/Data/Submit`
if empty or undefined	Submission not possible.
Explanation	The folder to which the SIPs are submitted.

`docuteamPacker.newSIPDeleteSourceByDefault`
Example	`true`
if empty or undefined	`false`
Explanation	If `true`, the original files are deleted after the SIP is created.

`docuteamPacker.newSIPDefaultsToZipped`
Example	`true`
if empty or undefined	`true`
Explanation	If `true`, the check mark "ZIP" is set by default when creating a new SIP. If `false`, the check mark is not set by default.

`docuteamPacker.migrateFileKeepOriginal`
Example	`true`
if empty or undefined	`true`
Explanation	During file migrations, the original file is replaced by the migrated version by default. If the option is set to `true`, both the source file and the migrated version are retained.

`docuteamPacker.versioning`
Example	`true`
if empty or undefined	`true`
Explanation	If `true`, the previous version will be saved as a backup in the folder `backupDir` during each save operation. If `false`, no backups are created and the original SIP will be overwritten each time.

`docuteamPacker.versioning.keepBackupsCount`
Example	`20`
if empty or undefined	`10`
Explanation	Maximum number of backups created. If the number of backups exceeds this value, the oldest backups are deleted.

`docuteamPacker.openFullScreen`
Example	`false`
if empty or undefined	`false`
Explanation	If `true`, the SIP editing window occupies the entire screen. If false, the two values `screenSize.x` and `screenSize.y` are used for the window size.

`docuteamPacker.screenSize.x`, `docuteamPacker.screenSize.y`
Example	`1200`
if empty or undefined	1000x700 Pixel
Explanation	The size of the SIP window in pixels. These values are ignored if `openFullScreen` = true.

`docuteamPacker.screenPos.x`, `docuteamPacker.screenPos.y`
Example	`500`
if empty or undefined	Zentriert
Explanation	The position of the SIP window when it opens. These values are ignored if `openFullScreen` = true.

`docuteamPacker.useSystemLookAndFeel`
Example	`false`
if empty or undefined	`false`
Explanation	If `true`, the appearance of packer is adapted to the computer's operating system. If `false`, a generic look ("Metal") is chosen.

`docuteamPacker.defaultChecksumAlgorithm`
Example	`MD5`
if empty or undefined	`SHA-512`
Explanation	Cryptographic hash function to calculate the checksum. Supported values are `CRC-32`, `MD5`, `SHA-1`, `SHA-256` and `SHA-512`.

`docuteamPacker.droid.signatureFile`, `docuteamPacker.droid.containerFile`, `docuteamPacker.droid.extensionUsage`
Example	`./config/DROID_SignatureFile_V90.xml`, `./config/container-signature-20170101.xml`, `1`
if empty or undefined	`./config/DROID_SignatureFile_V95.xml`, `./config/container-signature-20180920.xml`, `0`
Explanation	If DROID should not use standard configuration files, the values must be specified here.

`docuteamPacker.SA.getSAsFromServerOnStartup`
Example	`false`
if empty or undefined	`false`
Explanation	If `true`, the current list of Submission Agreements is downloaded from the web address entered in `SA.BASE.URL` when packer is started.

`docuteamPacker.SA.BASE.URL`
Example	`http://docuteam/sa`
if empty or undefined	No download
Explanation	The web address from which the current Submission Agreements are downloaded manually or when packer is started (if so set).

`docuteamPacker.OOConverter.path`
Example	`C:/Programme`
if empty or undefined	The internal OOO application is used, if existing. If not, the preview of some files is not possible.
Explanation	The folder in which the OpenOffice.org application is located, which is required for the preview of some files.

`docuteamPacker.OOConverter.initializationRetries`
Example	`30`
if empty or undefined	`10`
Explanation	The number of attempts to initialize the OpenOffice.org application. This is required for the preview of some files.

`docuteamPacker.pdftools.url`
Example	`tcp://10.0.0.123:7981/O2PService`
if empty or undefined	`tcp://localhost:7981/O2PService`
Explanation	The specifications for the 3-Heights Document Converter.

`docuteamPacker.filePreviewer.cacheSizeLimit`
Example	`20`
if empty or undefined	`100`
Explanation	The size of the cache for the preview of the files. The higher this value, the more previews packer keeps in memory.

`docuteamPacker.openSystemOutViewOnOutput`
Example	`true`
if empty or undefined	`true`
Explanation	If `true`, the error window is automatically opened when an error occurs. If `false`, the error window is not opened.

`docuteamPacker.SIPView.TreeExpandAll`
Example	`true`
if empty or undefined	`true`
Explanation	If `true`, all elements of the SIP structure are displayed by default.

`docuteamPacker.SIPView.DefaultTab`
Example	`1`
if empty or undefined	`1`
Explanation	When a value between 1 and 3 is entered, the corresponding tab is displayed by default in the detail view of a SIP. 1 corresponds to the object info, 2 to the description and 3 to the preview tab.

`docuteamPacker.SIPView.metadataOrder`
Example	`alphabetical`
if empty or undefined	none (i.e. order as defined in `levels.xml`)
Explanation	Order of the list of available metadata fields.

`docuteamPacker.DOIGenerator.nextNumberFilePath`
Example	`./config/doi-numbers`
if empty or undefined	`./config/NextNumber`
Explanation	File in which the last number used is stored.

`docuteamPacker.DOIGenerator.prefix`
Example	`doi-`
if empty or undefined	DOI is generated without prefix, i.e. a sequential number.
Explanation	Prefix, which is set before the sequential number for the identifier.

`docuteamPacker.CSV.mappings`
Example	`./config/csv-sip-mapping_1.xml;./config/csv-sip-mapping_2.xml`
if empty or undefined	defaults to `./config/csv-sip-mapping.xml`
Explanation	Paths to CSV mappings that will be used to populate the default mappings in the "Create new package from a CSV file" dialog. Multiple values should be separated by ';'. Use relative paths based on the packer executable location.

`docuteamPacker.actionsNotVisible`
Example	`deleteItemDontAskAction`, `deleteItemAction`, `deleteFileContentAction`, `exploreAction`
if empty or undefined	all actions are displayed
Explanation	List of actions (separated by commas) that are not displayed on the packer user interface.

fileNameNormalizer.properties

In file fileNameNormalizer.properties you can specify the patterns according to which file names are cleaned up when the action "Clean up file/folder names" is triggered. This option can be found in the SIP detail view window under "Item" > "Clean file/folder names". The operation is performed for all files and folders in the SIP. It is also performed in the order specified in the file.

The following parameters can be set:

`prefix`
Example	`PRE`
if empty or undefined	No prefix is set.
Explanation	This value is prefixed to the file name at the time of standardization. For example, the file name "043.jpg" becomes "PRE043.jpg" if prefix=PRE. The prefix may also contain spaces.

`suffix`
Example	`SUF`
if empty or undefined	No suffix is set.
Explanation	This value is added after the file name (before the file extension) at the time of standardization. For example, the file name "043.jpg" becomes "043SUF.jpg" if sufix=SUF. The suffix may also contain spaces.

`maxLength`
Example	`40`
if empty or undefined	No adjustment is made.
Explanation	The character length of the file name (without file extension) is cut to the corresponding number of characters. This includes configured prefixes and suffixes.

`fileNameRegex`
Example	`[a-zA-Z0-9.\\-\\/+=@_]*$`
if empty or undefined	The validation scheme is necessary for the proper functioning of packer.
Explanation	Validation scheme (regular expression) to determine whether all letters present in the file name are allowed.

charConversionMap.properties

The file charConversionMap.properties contains a conversion table of special characters, which is used for the automated standardization of file names. The assignments correspond to key-value pairs.

The source character (e.g. ç) can be displayed in the configuration file either as such (ç) or in the form of its UTF-8 code (in Java context \u00E/).

Some examples:

# replace ü with ue
ü=ue
# replace whitespace with _
\u0020=_
# replace ( with _
# \ has to be escaped (cf. https://docs.oracle.com/javase/8/docs/api/java/util/regex/Pattern.html)
\\u0028=_

pdfToolsConverterWS.properties

The file pdfToolsConverterWS.properties defines parameters that are used by 3-Heights Document Converter (PDF Tools) if it is implemented as a web service.

docuteamPacker.properties​

fileNameNormalizer.properties​

charConversionMap.properties​

pdfToolsConverterWS.properties​

docuteamPacker.properties

fileNameNormalizer.properties

charConversionMap.properties

pdfToolsConverterWS.properties