After creating the necessary configuration files you’re ready to set up DocumentRouter instances.
In order to create a new instance or edit an existing one, enter the KGS Document Router istance view by clicking in UI
Main → KGS DocumentRouter.
Within in the Instance Overview you may check the status, name, start and end time of each KGS DocumentRouter instance, as well as perform actions like creating a new instance, start or edit or stop an existing one as well as deleting an existing DocumentRouter instance.
The Actions column allows you to perform the following actions.
Symbol | Description |
---|---|
The play symbol allows you to start an existing instance. | |
The stop symbol allows you to stop a running existing instance. | |
The bin symbol allows you to delete an existing instance. | |
The gear symbol allows you to open the Instance configuration. |
Creating a new DocumentRouter instance
In order to create a new DocumentRouter instance, please click on the New Instance-button. This will open a modal dialog which allows you to define the name of the instance.
After clicking on the Create button, a new instance of DocumentRouter will be created and displayed within the instance overview.
You may now proceed to configure the created instance by clicking on the gear-symbol in the Action column.
Editing an existing DocumentRouter instance
After clicking on the gear-symbol, you’ll be lead to the configuration of this specific DocumentRouter instance. The configuration will be done in separate tabs, which are being described below.
After making changes in a tab and in order to take over these changes, please click the Save button!
SAP tab
Inside this tab SAP connections can be defined.
Parameter Name | Type | Description | Default Value |
---|---|---|---|
SAPLinkRemoteFunction | String | Within this field you may define the user function used for linking the documents to SAP Business Objects. By default the following user function will be used: ARCHIV_CONNECTION_INSERT (e.g.: ZKGS_ARCHIV_CONNECTION_INSERT) | ARCHIV_CONNECTION_INSERT |
SAPCommit | Checkbox | This parameter may be used togehter with your own user remote function in order to execute explicitily a commit on the SAP database after inserting a link entry into the SAP ArchiveLink table. false = No explicit commit will be done true = An explicit commit will be done | Unchecked |
SAPConnection | DropDown | Choose a SAP connection defined within the KGS SAP Connector. If no connection is required, please choose none. | None |
PerformKeySetBeforeArchiving | Checkbox | It is possible to get information from SAP via document id. If the document id is determined by external system, DocumentRouter can ask SAP before archiving for these information. Then while archiving via SAPALink it is possible to store these additional information as meta data into archive. In order to get these information before archiving this flag needs to be checked. | Unchecked |
BCSAPLinkObject | DropDown | The parameter BCSAPLinkObject defines whether a document should be linked to an SAP business object after archiving. This parameter serves as fallback in case no explicit definition was found. It’s good practice to always provide an explicit definition for the content repositories. In case multiple file types are being processed the definition of a single file name extension determines which document types are being linked to SAP (e.g.: pdf|txt → All documents with the file extensions .pdf or .txt will be linked to SAP) In this scenario it’s importat the the parameter DocumentMimetype doesn't contain any value. File extensions are not limited to specific values. available settings:
| 1 |
RecheckingType | DropDown | You may define the level of checks done for the linking process to SAP. You may choose from the following list provided by KGS DocumentRouter.
| None |
Salesforce tab
For linkng to salesforce this tab contains the following settings:
Parameter Name | Type | Description | Default Value |
---|---|---|---|
Salesforce Linking Enabled | Checkbox | to enable Salesforce linking. As counter part a Salesforce-Plugin is required. internal docu: /wiki/spaces/WIKI/pages/2113110021 | Unchecked |
Common tab
Archiving tab
This tab is for configuration related to archiving.
Parameter Name | Type | Description | Default Value |
---|---|---|---|
AL Connection Mapping File | String | Former known as SID-Mapping-File. Inside this file archive. link connections can be defined. Instead of content repository settings made in SAP the settings from this file is used. See https://kgs-software.atlassian.net/wiki/spaces/DOCUEN/pages/2311028919/DR4+-+Defining+DataInterfaces+SIDMappings+and+Archive+Link+Mappings#ArchiveLink-Connection-mapping | Empty |
Skip archiving | Checkbox | If enabled, archiving can be skipped. This may helpful for debug linking or for historical documents that have been archived already and only need to be linked to SAP. | Unchecked |
Lock | Checkbox | Does locking if archiving and linking was successfully. Default: true | Checked |
SMTP tab
In this tab the SMTP-Connector-Instances are configured, which shall receive DocumentRouter topic content.
Which topics exist and how DocumentRouter emailing works is described in DR4 - Mail support .
Parameter Name | Type | Description | Default Value |
---|---|---|---|
SMTPInstanceList | String | One or more SMTP configurations, by their name. The asterisk character acts as a wildcard ( * ), meaning all SMTP instances configured in the KGS SMTP Plugin. In case multiple instances should be notified, they must be separated by comma (,) | * |
Duplication detection time-out | int | An duplicated mail is suppressed (not sent) inside configured period [ms] after sending mail. | 86400000 |
Further information for the KGS SMTP Connector plugin is available here KGS SMTP Connector
Conversion tab
KGS Document Router offers the possibility to convert files before archiving.
Parameter Name | Type | Description | Default Value |
---|---|---|---|
ConvertTiff2Pdf | Checkbox | If set true, an tiff document file can be converted to pdf. | Unchecked |
Prolog tab
Within the Prolog tab you may define parameters necessary for DocumentRouter to find and use a prolog.
A prolog is an implementation inside a Java-Class residing in a jar file. The prolog mainly is before document router actions take place. In addition a prolog offers the opportunity to define a post action. The post action is called after all document router actions are done.
These actions allow you e.g. to reformat or change index data retrieved from an external source so it can be processed inside your existing workflows.
In case your workflows require one or more prolog classes you may ask KGS. We’ll gladly help you realize the functionality required by your workflows.
If you want use prologues, you need to provide the following parameters within the Prolog tab.
Parameter Name | Type | Description | Default Value |
---|---|---|---|
PrologClass | String | Within the field PrologClass you may provide a Java class name, with the initialization parameters in brackets, separated by a comma ( , ). Input files for the Prolog class will be gathered by KGS DocumentRouter through the parameter PrologFileFilter and handed over one by one to the Prolog class. Example: KGSCold(param1,param2,param3) Depending on your prolog it’s also possible to use a configuration file as a parameter. Example: KGSCold( C:\PrologConfiguration\config.ini ) | Empty |
PrologFileFilter | String | The file extension used for input files which shall be handed over to the Prolog class may be defined in the field PrologFileFilter. The files matching the filter working like a trigger. Example: .pro | Empty |
PrologLocation | String | In order to find the implementation, DocumentRouter needs the location, where it can find the prolog implementing classes. E.g. /opt/tomcat/prologs/MyExampleProlog.jar | Empty |
PrologUndeletedTriggerFileIsError | Boolean | If checked and the configured prolog is not deleting its trigger file, it will be marked as error. This will cause move/delete of this trigger file and so avoid an endless loop. If unchecked the prolog can skip a trigger file in order to handle it later. | Checked |
Authentication tab
Parameter name | Type | Description |
---|---|---|
Enable token authentication | Checkbox | Checked = Enables token authentication to access the DocumentRouter instance via REST Unchecked = No authentication needed |
OpenID discovery url | String | The discovery url defines the location of the openid configuration of the authentication server. This endpoint always ends with “/.well-known/openid-configuration“. E.g.: https://login.microsoftonline.com/<tenantId>/v2.0/.well-known/openid-configuration |
Token audience | String | The audience defines the resource identifier. The requested token must provide this predefined identifier so that the DR instance can validate access to its resources. |
Request DocumentRouter instance state by REST
In case you wish to check the status of multiple instances in a more textual way, you may also use an serverInfo-request against DocumentRouter in order to retrieve the status of all instances of DocumentRouter.
The request has to look like this: http://<IP address or hostname><:Port>/KGSAdmin-DR/documentrouter?serverInfo&pVersion=<0045 or 0046 or 0047>