Application Configuration

If you skipped the database settings section during the install, you must edit the configuration file which tells Dovetail Mobile Agent how to talk to the Dovetail database.

Application Settings

From the directory where you installed Dovetail Mobile Agent, in the webapplication subdirectory, edit the the web.config file using your favorite text editor.

Key

Required

Default

Comments

DovetailDatabase.Type

Yes

mssql

Your database type. Either mssql or oracle

DovetailDatabase.ConnectionString

Yes

Data Source=server; Initial Catalog=dovetail; User Id=user; Password=password;

Database connection string.
Note: Review the the Application User Permissions needed by the user Id in the connection string.

Seeker.IsSearchEnabled

Yes

True

Whether search is enabled or not.

Seeker.SeekerServiceUrl

Yes

http://localhost/seeker

The URL for Dovetail Seeker

Seeker.ExcludedSearchDomains

No

(empty)

Comma delimited list of search domains which you do not wish Mobile users to be able to search by.

DovetailDatabase.SessionTimeoutInMinutes

Yes

20

Number of minutes until an inactive session is terminated.

ItemHistory.AttachmentPathPrefixExpression

Yes

c:\\dovetail\\attachments

A regular expression used to match the path prefix for attachments, as used in doc_path entries.

Subcase.DueDateNumberOfDaysAfterCreation

Yes

7.0

When a subcase is created, the due date will be set to the creation date plus this value (in days).

Subcase.PriorWarningInHours

Yes

8.0

When a subcase is created, the warning notification for the upcoming due date will be set to the due date minus this value (in hours).

Attachment.AttachmentMode

Yes

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.

Attachment.FilePath

Yes

c:\\attach

A regular expression used to match the path prefix for attachments, as used in doc_path entries.

Dovetail SDK Settings

Any application settings present in the web.config which start with fchoice will be used when initializing the Dovetail SDK. For more information on available fchoice SDK configuration settings please see the Dovetail SDK documentation.


Sample Application Settings

Below is a sample of the application settings from the web.config shipped with Dovetail Mobile Agent:

<appSettings>
    <add key="DovetailDatabase.Type" value="mssql"/>
    <add key="DovetailDatabase.ConnectionString" value="Data Source=localhost; Initial Catalog=dovetail; User Id=sa; Password=sa"/>
    
    <add key="Seeker.IsSearchEnabled" value="true"/>
    <add key="Seeker.SeekerServiceUrl" value="http://mysearchserver/seeker"/>
    <!-- Comma delimited list of domain names which should not be used by mobile.-->
    <add key="Seeker.ExcludedSearchDomains" value="" /
    
    <add key="DovetailDatabase.SessionTimeoutInMinutes" value="20"/>
   
    <!-- When subcases are created the due date will be set by adding this value of days to the creation time -->
    <add key="Subcase.DueDateNumberOfDaysAfterCreation" value="7.0"/>
    <!-- When subcases are created the prior warning will be this many hours. -->
    <add key="Subcase.PriorWarningInHours" value="8.0"/>

    <add key="Attachment.AttachmentMode" value="ModeB" />
    <add key="Attachment.FilePath" value="c:\\attach" />
</appSettings>

See Also

Installation

Install the Dovetail SDK

Install Dovetail Mobile Agent

Update the Clarify Schema

Configure Dovetail Seeker

Configure Privileges

Import DAT file for Password Reset template

Optional - Configure Data Restriction

Next

Application User Permissions

Application Configuration