DR4 - Tab - Common

StartAutomatically

Checkbox

You may wish that a DocumentRouter instance automatically starts for examle after restarting the web server on which the KGS DocumentRouter has been installed on. In that case you need to check this checkbox, so that DocumentRouter automatically starts the processing as soon as the bundles is up and running.

Checked = The instance of DocumentRouter will automatically be started after KGS DocumentRouter is up and running

Unchecked = The instance has to be started manually.

Unchecked

ConnectionListFile

String

Within the field ConnectionListFile you may provide the name of the configuration file that contains the list of connections to the archiving systems.

Empty

WorkDirectory

String

DocumentRouter might create temporary files while processing the documents within the input directory. With the parameter WorkDirectory you may define where DocumentRouter stores temporary files.

E.g.: /opt/tomcat/documentrouter_workingdirectories/

<Webapp-Installation-Directory>/work/documentrouter/DocumentRouter.<Instance-Name>

ConfigDirectory

String

DocumentRouter allows you to put all the instance configuration files into separate directories. In order to find the configuration files of a specific instance you may provide in the parameter ConfigDirectory the path leading to the configuration files of a specific instance.

E.g.: /opt/documentrouter_configurations/deliveryorderimporter

<Webapp-Installation-Directory>/conf

LogDirectory

String

DocumentRouter will create a log file per instance which includes information like errors that occured during processing the documents within the input directory. With the parameter LogDirectory you may control, where DocumentRouter stores the generated log files.

E.g.: /opt/documentrouterlogs/

<Webapp-Installation-Directory>/log

LogFilename

String

The parameter LogFilename allows you to define the name and extension of the log file that will be generated by DocumentRouter.

E.g.: DeliveryOrderImporter.log

Empty

Debug

Integer

With the Debug parameter you may define the level of information being logged by KGS DocumentRouter.

The following levels are being supported.

0 = No information except for error messages and alive messages will be logged.

1 = Debug information as well as error messages and alive messages will be written to the LogFile.

2 = Debug information will be written to the LogFile as well as the console.

Empty (→ 0)

KeepLogfileDays

Integer

Within the field KeepLogfileDays you may define a number of days. DocumentRouter will split the log file into daily logs and keeps the number of defined daily logs as specified. Log files older than the defined amount of days will be removed by DocumentRouter.

E.g.: 30 (Will keep one month of log files before removing those older than 30 days).

Empty (→ 0)

InputSortMode

DropDown

InputSortMode allows you to define which documents within the input directory shall be processed first.

The following values are supported.

0 → Documents will be processed as they occur within the file system

1 → Documents will be processed starting with the oldest modification date first.

2 → The newest documents (modification date) will be processed first.

3 → Documents with the oldest creation date shall be processed first.

4 → Documents with the newest creation date shall be processed first.

Filesystem order

SAPALinkInterface

DropDown

With the parameter SAPALinkInterface you may define whether communication between the OMS connector and the DMS is based on KGS SAPALINK interface.

Spezifies how the DocumentRouter communicates with the DMS.

• ArchiveLink: use standard SAP ArchiveLink ( no late locking)

• SAPALink: KGS SAPALINK interface is being used by many ArchiveLInk 4.5 certified DMS solutions.

• KGS DocumentAccess API: uses a direct connection via KGS DocumentAccess API using its own default certificate for signing command URLs.

More information can be found in https://kgs-software.atlassian.net/wiki/spaces/DOCUEN/pages/2339143683/DR4+-+SAP+Connections#SAP-Connections-for-archiving

ArchiveLink

DocumentDirectory

String

The parameter DocumentDirectory defines which directory will be watched for input data. Index, document or prolog trigger files are expected there.

E.g.: /opt/documentrouter_input/deliveryorders

Empty

SubDirs

Integer

In case the input does have a structure with subdirectories coupling together image, index and Prolog files you may change the behavior how DocumentRouter scans the input directory for these kind of files by setting the parameter SubDirs.

The following values are supported.

• 0 → DocumentRouter does not expect nor scan subdirectories. Therefore image, index and Prolog files are located directly in the DocumentDirectory

• 1 → Image, index and Prolog files are located in subdirectories residing in the DocumentDirectory

• 2 → DocumentRouter will scan the entire directory tree for index and prolog files. This also includes the moving to the Failure and Success directory in case of an error, keeping the subdirectory structure as it was found.

0

MaxFileFetch

Integer

Using the parameter MaxFileFetch allows you to limit the number of input files fetched at once per cycle.

The default is 50.

Valid range: 1..N

50

NoDocTypeForSAPLink

Checkbox

The parameter NoDocTypeForSAPLink defines how mime types of the image file shall be handled.

• checked → The mime type of the image file will be handed over to the SAP remote function for object linking.

• unchecked → No mime type will be handed over, so the mime type of the ArchiveLink customizing for the used document type will be used ( the types for the ArchiveLink customizing are being defined in the transaction OAC2 in SAP).

Unchecked

UseSAPMimeTypes

Integer

When enabling the parameter UseSAPMimeTypes DocumentRouter won’t determine the mime type for the archived document itselfs, but rather look up within the SAP system defined through the BCSAPxxx-connection-parameters which mime type the archived document has.

0

RestrictFilesize

Integer

With the parameter RestrictFileSize you may create the restriction that only files of a configured size in bytes are to be archived. Smaler files are skipped.

Example: 0 → Files of zero byte data length will not be archived.

Empty (Unrestricted)

CheckHash

Checkbox

Depending on your scenario and needs you may wish to make sure that files are archived are the same as in DocumentRouter input folder.

The DocumentRouter calculates hash before sending to DMS and compares it with the hash retrieved by the DMS after archiving.

• unchecked → There will be no hash checks regarding the archived documents

• checked → Hash checks will be enabled.

Unchecked

SetAccesDateOnMove

Checkbox

The parameter SetAccessDateOnMove defines the behavior of DocumentRouter whether it should change the last access date of the index and image files when moving them either to the Succes or Failure directory.

• unchecked → The last access date will not be changed during the move.

• checked → The last access date will be changed to the current date and time when moving the files.

Checked

MoveOnOKUnique

Checkbox

In case you enabled the parameter MoveOnOK, DocumentRouter will move the files from the DocumentDirectory to a Success directory. If files of the same name already exist, they’d be overwritten. The parameter MoveOnOKUnique prevents this by creating unique sub directories within the Success directory and moving the files there.

• unchecked → DocumentRouter will simply move files to the Success directory and override already existing documents of the same name.

• checked → DocumentRouter will prevent the override of files already existing in the Success directory.

Unchecked

MoveOnError

Checkbox

With the parameter MoveOnError you can control, whether DocumentRouter shall move documents and index files to a Failure directory created within the DocumentDirectory when processing of the document fails.

• unchecked → If the processing fails the image- and index files will remain within the Document Directory

• checked → If processing fails the image- and index files will be moved to a Failure directory.

Checked

MoveRename

Checkbox

Meanwhile MoveOn…Unique moves to subfolders, MoveRename causes destination file renaming if there is already a file with same name existing. The renaming scheme is realized like in MS Windows.

e.g.: MyFileName.txt => MyFileName(1).txt

related : DEV-1483

Checked

RefineErrorDir

Checkbox

If checked, documents causing errors inside Failure folder will be sorted into sub folders according its error type.

Unchecked

MoveOnErrorUnique

Checkbox

In case you enabled the parameter MoveOnError, DocumentRouter will move the files from the DocumentDirectory to a Failure directory. If files of the same name already exist, they’d be overwritten. The parameter MoveOnOKUnique prevents this by creating unique sub directories within the Success directory and moving the files there.

• unchecked → DocumentRouter will simply move files to the Failure directory and override already existing documents of the same name.

• checked → DocumentRouter will prevent the override of files already existing in the Failure directory.

Unchecked

MoveOnOK

Checkbox

With the parameter MoveOnOK you can control, whether DocumentRouter shall move documents and index files to a Success directory created within the DocumentDirectory when processing of the document wasn’t successful.

• unchecked → If the processing is successful the image- and index files will be deleted from the DocumentDirectory

• checked → If processing is successful the image- and index files will be moved to a Success directory.

Unchecked

KeepSavefileDays

Integer

You can control with the parameter KeepSavefileDay how long DocumentRouter shall keep files in the Success directory for the amount of days defined in it. Files older than the defined amount of days will be reorganized (and deleted) after the start-up of DocumentRouter and after the first move of files to the Success directory after midnight.

The following values are supported.

• 0 → Files will be kept without automatic deletion.

• 7 → Files will be kept for a week and will be deleted if they are older than a week

• 30 → Files will be kept for a month and will be deleted once they’re older than a month.

You may enter any positive number of days.

0

IgnoreDuplicates

Checkbox

It’s possible that a document ID already contains a component of the same name in the archive. With the parameter IgnoreDuplicates you can control, whether this fact is being treated as an error or not.

• checked → Duplicates will not be treated as errors.

• unchecked → Duplicates will be treated as errors.

Unchecked

CleanupOnError

Checkbox

It’s possible that only part of the proccessing fails (e.g.: document could be archived, but linking to SAP fails). These circumstances would lead to a document existing within the archive, but you wouldn’t be able to read it via SAP. With the parameter CleanupOnError DocumentRouter will try to remove any component in the archive that might have been created during the processing of that specific document.

• unchecked → no cleanup after a processing error

• checked → cleanup on failure.

Unchecked

ConversionMode

Integer

You may switch the parameter ConversionMode to 1 in case your’re using IBM OnDemand input files which shall be parsed by DocumentRouter.

• 0 → DocumentRouter will not parse IBM OnDemand input files.

• 1 → DocumentRouter will parse IBM OnDemand input files.

0

TranslateUNICODE
(Index File Encoding)

DropDown

Determines how DocumentRouter reads index files.

These encodings can be configured:

• system default

• ASCII

• ISO-8859-1

• UTF-8 (default)

UTF-8

DisableCharsetDetection

Checkbox

Unchecked

ImageFileCheck

Checkbox

DocumentRouter will check whether image files are accessible or not before processing them.

• unchecked → accessibility will not be checked before document file processing

• checked → check whether the document file is accessible before starting to process it.

Unchecked

ShortGUID

Checkbox

With the parameter ShortGUID you can control the length of the document IDs created by DocumentRouter.

• unchecked → Document IDs of a length greater than 32 characters are allowed.

• checked → Document IDs will not exceed 32 characters.

Unchecked

IndexSkipLineStartsWith

String

The parameter IndexSkipLineStartsWith allows you to define lines within the index files starting with words or characters, that shall be skipped. (Comment lines)

Empty

TriggerByCommandfile

String

In case you’re using command files you may want to make sure, that DocumentRouter only archives documents for which a command file exists. The file has to follow this naming convention.

<Same prefix of the sub directory where index file resides in><Name>.<SUFFIX>.

The suffix is the config value.

e.g. triggering index file is named “myfile.idx“ and this config value is “rdy”, then a file named “myfile.rdy” is required to execute. If the rdy file is missing the routing execution is skipped for this round.
This feature can be used in case of network share usage. Image and index file transfer costs time. This feature can be used to prevent the DR from starting processing before the transfer is complete. The delivering process has to generate an empty rdy file after transmission. DR will delete the command file (in this case rdy).
Feature reintroduced after DR 5.0.4. Preceeding feature was existing in DR3 but a bit different config value.

Empty

DescriptionFileFilter

String

Within the field DescriptionFileFilter you may provide a list of extensions, separated by a semikolon ( ; ) which defines the extension of the index files.

E.g.:

• .RDI (in case you’re using SAP RDI)

• .idx (in case you’re using Streamserve)

Empty

DataInterface

String

The parameter DataInterface defines which interface definition has to be used from schema definition file.

Empty

DataInterfaceDefFile

String

The field DataInterfaceDefFile should contain the name of the configuration file which contains the different DataInterface configurations. (schema definition file)

E.g.: ImportSchema.conf

Empty

DocumentFileExtension

String

In case a document file isn’t specifierd by index file, you may provide a list of document file extensions separated by a semikolon ( ; ) which help DR to finde corresponding document file.
If the DR works without index file, all documents according this filter will be picked up for routing.
E.g.: .tif;.pdf;.txt;.xls

Empty

DocumentMimetype

String

Defining the parameter DocumentMimetype allows you to control which input format DocumentRouter will use for the document files. In case it’s left empty the document mime type will be determined by the extension of the document file.

E.g.:

• application/pdf

• application/xml

• image/tiff

• text/plain

Empty

DocumentRegExCheck

String

Allows to specify a regular expression that works as a whitelisting filter.
The filter is applied only on the file name. (not whole path)

If this field contains content, only documents with matching base filenames (e.g. Invoice42.pdf) will be processed.

For example the regular expression prefix_(.+)\\.pdf would match files with a name like prefix_something.pdf

Documentation of the syntax can be found here: https://docs.oracle.com/en/java/javase/11/docs/api/java.base/java/util/regex/Pattern.html

Empty

ArchivDocIDRegExCheck

String

Allows to specify a regular expression that works as a whitelisting filter.

In scenarios where document IDs are externally supplied, this field allows to filter processing by matching the document ID to this regular expression. Documents will only be processed if the supplied document ID matches this expression.

Documentation of the syntax can be found here: https://docs.oracle.com/en/java/javase/11/docs/api/java.base/java/util/regex/Pattern.html

Empty

FailureRetry

Integer

Using the parameter FailureRetry allows you to define the number of attempts DocumentRouter does repeating the processing of an input file before it marks a document file as a failure and moves it to the Failure directory or deletes it.

5

DelayProcessing

Integer

In case it’s necessary in your scenario or environment you may define a delay in seconds between processing of input files using the parameter DelayProcessing.

E.g.:

• 5 → DocumentRouter will wait for 5 seconds between processing the next input file

• 60 → DocumentRouter will wait for 60 seconds between processing the next input file.

• 0 → DocumentRouter will not wait between processing the next input file.

0

DirNotificationMark

Integer

DocumentRouter has the ability to send an e-mail when a certain number of documents were moved to the Failure directory.

This mail will only be send once and the next alert e-mail will only be issued under the following conditions.

• The server or KGS DocumentRouter have been restarted

• The amount of files within the Failure directory has been moved manually reducing the below notification level and the level is being exceeded again.

E.g.:

• 5 → DocumentRouter will send a warning e-mail in case the number of documents that have not been processed successfully reaches 5 documents or above.

• 50 → DocumentRouter will send a warning e-mail in case the number of documents that have not been processed successfully reaches 50 documents or above.

0

ProcessTimer

Integer

With the parameter ProcessTimer you may define a processing cycle in seconds after which DocumentRouter checks the input directory for new input files to process. This wait time is only applied if no matching prolog or index files were found in current cycle.

E.g.: 60 → DocumentRouter will check after every minute whether there are new input files within the DocumentDirectory

20

Repositories

String

Within the Repositories field you may provide a list of all SAP content repositories that are going to be connected to DocumentRouter. Each repository has to be separated by a comma ( , ).

In case the SAP system ID is provided within the index data the content repositories can be defined specifically for a single SAP system. This is useful in case repositories of the same name but in different SAP systems should be used.

E.g.: FI,SD,CO,HR

Empty

BarcodeDetect

Integer

You may enable the barcode detection by providing the sum of one or more possible combinations of barcodes in order to let DocumentRouter do a barcode detection from image files. Right now the following image file formats are supported.

• TIFF

• GIF

• JPEG

• PDF

You may either add the number corresponding to the barcode listed below or a sum of two or more barcodes making DocumentRouter look for these in the image file.

• 1 → Code 128

• 2 → EAN8

• 4 → EAN13

• 8 → UPCA

• 16 → UPCE

• 32 → Code 39

• 64 → Interleaved 2 of 5

• 128 → Identcode

E.g.:

• 32 → DocumentRouter will look for barcodes matching the Code 39 standard within the image file

• 255 → DocumentRouter will look for all barcodes mentioned above within the image file

• 48 → DocumentRouter will look for UPCE and Code 39 barcodes.

0

BarcodeBatch

Integer

When using the barcode feature of DocumentRouter you may define the actual behavior using the parameter BarcodeBatch.

The following values are supported.

• 0 → DocumentRouter will not scan the documents for barcodes.

• 1 → DocumentRouter searches for barcodes on every page and separates single documents.

• 2 → DocumentRouter will search for a single barcode on the first page of a document.

0

RepositoryMappingFile

String

Depending on your scenario it might be necessary to reroute between old and new content repositories. If you have defined a repository mapping file you may enter the name of that file in here, so that DocumentRouter remaps the content repositories internally.
see: DR4 - Repository Mapping

Empty

EncodeSchemaPwd

Checkbox

When you’re entering a password in the field EncodeSchemaPwd DocumentRouter shall encrypt the passwords provided within the SID Mapping file.

Unchecked

UserMimeTypes

String

Within the field UserMimeTypes you may provide a list of document types which will be mapped against mime types.

Empty

Multipart memoryprocessing max size per file

Integer

Sets the size threshold beyond which files are written directly to disk.

Value in byte. If the uploaded file is smaller than this limit it will be hold in memory and can take advantage of in memory processing.

2147483647 (in bytes → 2GB)