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 .

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

Topic name

Description

ArcDocIDRegExError

If document id doesn’t match given regualar expression
(see DR instance common tab)

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.

Related Articles and Links