Service Configuration

The DovetailCarrierService.exe.config file defines the application configuration parameters for the Dovetail Carrier Windows service. You will also need to edit the configuration of any Dovetail Carrier extensions that are in use.

Service Configuration Reference
Attribute Required Default Description
DovetailCRMSettings.
DatabaseType
Yes MSSQL Database Type. Valid values: MSSQL, Oracle
DovetailCRMSettings.
DatabaseConnectionString
Yes Data Source=serverName; Initial Catalog=dovetail; User Id=myUsername; Password=myPassword; Database connection string.

For MSSQL databases:

Data Source=serverName; Initial Catalog=dovetail; User Id=myUsername; Password=myPassword;

For Oracle databases:

Data Source=OracleConnectionString;User Id=myUsername;Password=myPassword;
DovetailCRMSettings.
EmployeeUserName
Yes sa Login Name of user/employee used when performing actions within the CRM system.
DovetailCRMSettings.
DatabaseType
Yes MSSQL Database Type. Valid values: MSSQL, Oracle
DovetailCRMSettings.
AttachmentsFilePath
Yes c:\attach The root path for saving file attachments.
This can be a local path (c:\directory) or a UNC path (\server\directory)
DovetailCRMSettings.
AttachmentMode
No ModeB Specifies which sub-folder mode Dovetail Mobile Agent should use when saving attachments.

NOTE: The value is NOT case-sensitive (i.e. 'modea' works as well as 'MODEA').

Valid values are:

ModeA: Put all files directly into the path specified by attachPath.

ModeB: Put attachments in subfolders using the CASE ID as a folder prefix.

For example, if the attachPath is set to "c:\attachments", attachments from Case 1792 will be stored in the path:

C:\attachments\001xxx\001792\

This mode groups up to a 1,000 cases in a grouping folder to help organize the attachments.

ModeC: Similar to ModeB but the folder names are slightly different.

For example, if the attachPath is set to "c:\attachments", attachments from Case 1792 will be stored in the path:

C:\attachments\1700\1792\

This mode groups up to 100 cases in a group folder to help organize the attachments.
MessageBusSettings.
MessageQueue
Yes msmq://localhost/dovetail.carrier The URI of the message queue that Dovetail Carrier will look for messages.
MessageBusSettings.
ConcurrentConsumers
No 2 * Number of CPUs The number of messages processed concurrently.
RegularExpressionSettings.
TimeoutInSeconds
No 30 Number of seconds a regular expression will execute before timing out. Timed out expressions will throw an exception.

Many extensions use regular expressions to drive how message processing is handled. It is possible that in some rare cases a complex regular expression for certain inputs could runaway. This timeout is a relief value preventing the message consumer from getting stuck evaluating a regular expression.
Email Service Configuration

Email Service Configuration

Email Account Configuration

Email Account Configuration

Extension Configuration

Please see the configuration reference for any Dovetail Carrier extensions you are using.