DR4 - Mail support
About
The DR is capable to inform email recipients on several events. This section explains how this feature is working and which configuration items exists.
Content
Introduction
Since DR 3.1.32 the DR has not anymore its own SMTP implementation. It uses an KGS common approach, now. This approach is realized by the usage of the KGS SMTP Connector .
Configuration
In order to use it, we need to choose the instances configured in SMTP Connector plugin by configuring a comma separated list of KGS SMTP Connector instances.
see:
How it works
In KGS SMPT connector plugin you can configure instances. Every instance contains beside the SMTP credentials topics and email recipients. I will call it a tupel.
The DR configures to which of this tupels it will propagate all of its events.
So we need to configure these:
configure an recipient list and the topics to be covered in KGS SMTP Plugin as an instance
configure the DR so, that it sends its events to this SMTP instance
You may configure several such KGS SMPT plugin instances with different recipient groups and topic. In this case you need to propagate the DR plugin events to all of these KGS SMPT plugin instances.
Events
The DR is producing some events. E.g. if the has happen an SAP error. These events are mapped to topics. The event is a topic. It is a one by one relation. Ergo every event is send to its own topic.
Topics
The DR is producing these topics:
Topic name | Description |
---|---|
ArcDocIDRegExError | If document id doesn’t match given regualar expression |
ArchiveError | In case an error occured during the archiving stage, this topic will be triggered. |
BarcodeNotFound | In case your scenario expects barcodes and none was found, this topic will be triggered and DocumentRouter will create an email which will be sent to everyone defined in instances dealing with that issue. |
CompExists | This topic will be called in case a component already exists during the document processing. See DR instance tab common: CheckHash |
CompExistsHashError | In case there has been a mismatch between the expected hash value and the actual received hash, this topic will be triggered. See DR instance tab common: CheckHash |
CompExistsNoHash | This topic will be triggered in case no hash value could be found for an existing component. See DR instance tab common: CheckHash |
DocumentDirectoryAccess | In case DocumentRouter can not access the defined Document Directory this topic will be triggered and (if instances exist, which deal with that topic) mails will be sent informing the users or mail boxes about this issue. |
DirNotification | In case the number of documents within the Failure direcotry surpasses the defined amount this topic it will be triggered and the users or mail boxes defined in the instances dealing with that issue will be informed by an email. |
FilesizeRestricted | In case you restricted your scenario to certain file sizes (e.g.: Not processing and archiving zero-Byte files) and a file which matches with that restriction appears, an email will be sent to every SMTP instance dealing with that restriction. |
GeneralError | For error codes not covered by others. |
InvalidIndex | If an invalid index file has been provided, this topic will be triggered and emails will be send. |
InvalidLicense | If an DR instance is started and the license is invalid / expired. |
NoImageFile | When DocumentRouter couldn’t find an image file (document references in index file), this topic will be triggered. |
SAPError | In case an error appeared during the communication with the SAP system, this topic will be triggered. |
SAPErrObjNotFound | Belongs to SAP remote function (ZKGS_NOE_ARCHIV_CONNECTION_INS). If SAP-Object does not exist, SAP will throw an exception while SAP linkining |
VolumeMark | In case the number of processed documents surpasses the defined percentage value, DocumentRouter will generate a warning email and send it to every user or mailbox defined by instances dealing with that issue. |