fchoice Section

RuleManager specific configuration settings:

Parameter Name

Required

Default

Description

ApplicationEventExecutor.
StopApplicationIfEmailServiceIsDown

No

true

When an email cannot be sent and the maximum number of retries has been exceeded, the application by default will stop. If this setting is false the application event will be rescheduled to the far future and the application will continue running.

EmailServiceConfig.
DefaultFromEmailAddress

Yes

email@domain.com

The email address that RuleManager should use in the FROM: field when sending out emails.

EmailServiceConfig.
DefaultFromEmailAddressDisplayName

No

Company Support

The display name for the default From email address. For example, the default settings would be seen as Company Support <email@domain.com>.

EmailServiceConfig.
UseDefaultFromEmailAddressForAllMessages

Yes

false

When RuleManager sends emails, it can honor the "FR:" token in the com_tmplte, or not. If this setting is set to true, then all emails will be sent from one address (EmailServiceConfig.DefaultFromEmailAddress). If set to false, and the com_tmplte has a "FR:" token, then the "FR:" token will be used.

For example, when sending an email out, the send_email_about_obj com_tmplte is used. The baseline com_tmplte has "FR: " in it. If UseDefaultFromEmailAddressForAllMessages is set to true, then the email will come from the EmailServiceConfig.DefaultFromEmailAddress. If UseDefaultFromEmailAddressForAllMessages is set to false, the the email will come from the actual sender of the email.

EmailServiceConfig.
EnableTestMessage

Yes

true

Should test message be sent during application startup to validate SMTP configuration?

EmailServiceConfig.
TestEmailAddress

Yes

test@domain.com

Email address which will receive the startup test email message.

EmailServiceConfig.Host

No

emailServer

IP or hostname of the SMTP server. If left blank, localhost will be used.

EmailServiceConfig.Port

No

25

The TCP/IP port to use when connecting to the SMTP server.

EmailServiceConfig.EnableSsl

No

false

pecify whether the SmtpClient uses Secure Sockets Layer (SSL) to encrypt the connection.

EmailServiceConfig.UserName

No

 

The username to use when connecting to the SMTP server. Some SMTP Servers require authentication.

EmailServiceConfig.Password

No

 

The password to use when connecting to the SMTP server. Some SMTP Servers require authentication.

EmailServiceConfig.Timeout

No

100

Sending an email will timeout if the send is not completed after this many seconds.

EmailServiceConfig.
SignOutgoingEmails

No

false

When true RuleManager will look for a valid digital certificate for the sending email address. If found the outgoing email will be digitally signed using the certificate.

EmailServiceConfig.
ParseMarkdown

No

false

This setting enables or disables Markdown parsing of emails. More information is available in the HTML Emails section.

ApplicationEventProcessorState.
NumberOfWorkerThreads

Yes

10

Number of time_bombs that will be executed simultaneously.

See Also:

Number of Worker Threads

ApplicationEventProcessorState.
PollingIntervalMilliseconds

Yes

1000

How often the application polls the database for expired time_bombs.

ApplicationEventProcessorState.
ApplicationEventChunkSize

Yes

200

The total number of expired time_bombs that will be retrieved per database poll.

VolitileResourceExecutor.
NumberOfRetries

Yes

300

Retry mechanism when the application communicates with external resources such as the database or smtp server. How many times should it retry before giving up.

VolitileResourceExecutor.
RetryDelayMilliseconds

Yes

2000

Retry mechanism when the application communicates with external resources such as the database or smtp server. How long to wait between retries.

NotificationConfig.
DefaultNotification

Yes

Email

If notification recipient does not have a notitification preference this is how the user will be notified.
Valid options: EMAIL, NOTIFIER, FORWARD TO MY SUPERVISOR, NONE

NotificationConfig.
PagerApplicationPath

No

(blank)

The path and filename of the paging application. Example: c:\paging\pager_clerk.bat

LicenseValidator.
LicenseExpirationWarningDays

Yes

30

Number of days prior to license expiration that warnings will be logged. It will repeat these warnings every day. This warning will be logged using the standard logging mechanism (log4net), so be sure that your logging is configured properly.

Resource.ResourceStore

No

 

Where are inline images retrieved from. Valid values are S3 or Seeker

Search.ResourceTimeout

No

1000 days

How long should inline image URLs be valid for.

Search.TokenIsUnique

No

True

Determines whether a Dovetail SeekerProxy URL for an inline image will have a unique token or not. Leave as True.

Carrier.QueueAddress

No

msmq://localhost/dovetail.carrier

Address of Dovetail Carrier's incoming message queue. Typically used as part of Dovetail Task Manager.

Sms.EmployeeSmsField

No

beeper

By default, Rulemanager will use the employee's Pager number to send SMS messages. By default, the label in the UI is "Pager", and this maps to the beeper field on the employee table (table_employee.beeper) If you wish to use a different field on the employee table, you can do so by editing the Sms.EmployeeSmsField configuration setting.

Twilio.From

No

 

Your Twilio phone number used to send SMS messages

Twilio.AccountSid

No

 

Your Twilio SID

Twilio.AuthToken

No

 

Your Twilio Authentication Token

Amazon S3 settings

These settings apply when HTML emails contain links to an image stored in Amazon S3 (such as those sent from Dovetail Agent version 8 and later).

More information is available in the HTML Emails section.

Parameter Name

Required

Default

Description

S3.AWSId

No

Your AWS ID

Your Amazon Access Key ID

S3.AWSSecret

No

Your AWS secret

Your Amazon Secret Access Key

S3.Bucket

No

Your S3 Bucket

S3 bucket where files will be downloaded from

S3.Region

No

us-east-1

When creating a bucket if you select any region beside "US Standard" you will need to configure this setting with the correct region string.

S3.KeyPrefix

No

agent-images

A prefix represents a set of keys in the S3 bucket that allows applications to organize and browse their keys hierarchically, similar to how a file system organizes files into directories.

S3.DownloadURLLifeSpan

No

5500 days

Maximum value is "5500 days"

See Also

Configuring RuleManager

appSettings Section

log4net Section

configSections

Number of Worker Threads

Next

log4net Section

fchoice Section