Adjusting property values in the subscription.properties file will affect when multiple event notifications are sent. Property values in this file also change the time interval for an event to be considered part of the same transaction on an object. A transaction is any action on an object that occurs within the time interval set by the timeGap property. Two properties in the subscription.properties file can be changed to reduce the incidence of multiple email notifications for a single transaction.
Change the spamOK property to spamOK=no. This will send only one notification per transaction to a user.
If necessary increase the timeGap property to a higher value. This will increase the transaction time interval.
NOTE: If timeGap is set too high it may eliminate desired notifications of events. For example if a user adds a new version of a document and also changes the ACL permissions of the document within the timeGap interval. Both events will be considered a single transaction. Only one email notification will be sent although two unique events occurred on the document.
The subscription.properties file is located in /config. Edit the file using an ASCII text editor such as Notepad.exe.
New Subscription Properties in DocuShare 4.0
The following properties are new to DocuShare 4.0. The list below describes the properties and their usage.
This property triggers the garbage collection process to remove cached outdated events. Default is 10 Minutes. Garbage collection time can be shortened on systems where a high volume of uploads or changes are driven by automated processes or scripts. This will reduce the memory required for caching outdated events. Running garbage collection more often can have a negative impact by increasing processing overhead.
Used for diagnostics. When Subscription logging level is set to TRACE or DEBUG and printDebugTime=yes the processing time for internal processes is written to the log.
Default is 100 milliseconds. This value sets the time interval for an event to be considered to be from the same transaction. For example if a new version of a document is added and a property change occurs on the new version within 100 milliseconds the two events are considered to be one transaction. Only one notification event will be sent out.
Default is spamOK=yes. When set to spamOK=no only one subscription message per recipient per transaction will be sent. This works in conjunction with the timeGap= property to set time interval for a transaction.
Default is blank. This property is used to specify event type(s) that will be skipped for subscription processing. Specify a string of comma separated events in a single line. Valid types are: OBJECT_CREATED, OBJECT_PROP_CHANGED, OBJECT_PUBLISHED, OBJECT_DELETED, OBJECT_EXPUNGED, LINK_CHANGED, OBJECT_ACL_CHANGED, OBJECT_OWNER_CHANGED, OBJECT_CLASS_CHANGED, OBJECT_RESTORED, DOCUMENT_LOCKED, DOCUMENT_UNLOCKED, LOGIN_SUCCEEDED, LOGIN_FAILED, SUBSCRIBE_DAILY, SUBSCRIBE_WEEKLY, CLASSES_CHANGED, CLASS_LABEL_CHANGED, CONFIG_CHANGED
The password for accessing authenticated SMTP session. Customer enters the password of the DocuShare Admin email account as plaintext. An encrypted string replaces it after DocuShare is running. For SMT service that allows anonymous access an encrypted empty string is displayed.
Indicates the main DS version for which patches apply for. Do not change this value unless directed to by DocuShare Customer Support.