The RoleTailored client is a component of the RoleTailored Architecture in Microsoft Dynamics NAV 2009.

As you run Microsoft Dynamics NAV 2009 Setup, you can provide configuration information for the RoleTailored client. This information is then saved in the ClientUserSettings.config file.

A separate instance of the ClientUserSettings.config file is maintained for each client user. On Windows Server 2003 or Windows XP, the location of this file is Documents and Settings\<username>\Local Settings\Application Data\Microsoft\Microsoft Dynamics NAV.

On Windows 7, Windows Vista, or Windows Server 2008, the location is Users\<username>\AppData\Local\Microsoft\Microsoft Dynamics NAV.

This file is hidden by default. Change your folder options in Windows Explorer to view hidden files before you edit the ClientUserSettings.config file.

Configuring the RoleTailored Client in Setup

You can configure the RoleTailored client when running Microsoft Dynamics NAV 2009 Setup. You must first select the RoleTailored client as a component to install. To do this, select one of the following Installation Options that includes Microsoft Dynamics NAV Server:

You can also customize your installation and customize the list of components to install. For more information, see How to: Choose Components to Install.

After you specify an installation option or customize your component list, the Specify parameters pane is displayed in Setup. Click RoleTailored Client to open the Installation Parameters pane. The underscore indicates that this component is configurable.

Settings

The list of parameters that you see in the Specify parameters pane depends on which components that you have selected for configuration. The following parameters pertain to the RoleTailored client.

Parameter Description

Server Name

The name of the computer running Microsoft Dynamics NAV Server for this client.

Default value: Blank if you install using the Client installation option or localhost if you install using the Developer Environment installation option or a custom installation.

Server Port

The listening TCP port for the computer running Microsoft Dynamics NAV Server for this client.

Default value: 7046

Caution noteCaution

If you specify an invalid port number in Setup, then the RoleTailored client cannot connect to Microsoft Dynamics NAV Server. You will receive the following message when you attempt to open the RoleTailored client:

The program could not create a connection to the server. Do you want to try again?

If you click No, then the Select Server window opens. Correct the port number by typing a string in this format in the Server name field:

  CopyCode imageCopy Code
servername:port/ServerInstance

Click Apply when you have finished entering values to return to the Specify parameters pane in Setup.

After you finish running Setup, you can modify Microsoft Dynamics NAV Server settings.

Configuring the RoleTailored Client After Installing

After you install the RoleTailored client, configuration settings are stored in the ClientUserSettings.config file. If you have configured the RoleTailored client in Setup, then your setting values are included in this file.

In addition to the settings that you can configure in Setup, the ClientUserSettings.config file contains other settings for the RoleTailored client. After you modify the ClientUserSettings.config file, you must restart the RoleTailored client for changes to take effect.

Settings in the ClientUserSettings.config File

The ClientUserSettings.config file is an .xml file that you can edit with any text editor. Quotation marks are required for all values.

NoteNote

The ClientUserSettings.config file is hidden by default.

The following settings are available.

Setting Description

Server

The name of the computer running Microsoft Dynamics NAV Server for this client.

Default value: Empty string if you installed using the Client installation option or localhost if you installed using the Developer Environment installation option or a custom installation.

ServerInstance

The name of the computer running Microsoft Dynamics NAV Server.

Default value: DynamicsNAV

You may need to modify this value if you have more than one instance of Microsoft Dynamics NAV Server installed on a single-server computer. For more information, see Walkthrough: Accessing Multiple Microsoft Dynamics NAV Databases from a Single Microsoft Dynamics NAV Server Computer.

ServerPort

The listening TCP port for the computer running Microsoft Dynamics NAV Server for this client.

Default value: 7046

ProtectionLevel

The security services for protecting the client/server data stream. This value must match the value that is specified in the Microsoft Dynamics NAV Server configuration file. For more information, see Configuring Microsoft Dynamics NAV Server.

Default: EncryptAndSign

Values: EncryptAndSign, Sign, None

CompressionThreshold

The threshold in memory consumption at which the RoleTailored client starts compressing datasets, in kilobytes.

Default: 64

ChunkSize

The default size for a chunk, in kilobytes.

Default: 28.

The range of values is from 4 to 80.

AllowNtlm

The value for whether NTLM fallback is permitted for authentication.

To require Kerberos authentication, set this value to false.

Default value: true

ServicePrincipalNameRequired

If this parameter is set to true, then the client can only connect to a Microsoft Dynamics NAV Server service that has been associated with a service principal name (SPN).

If this parameter is set to false, then the client attempts to connect to the configured Microsoft Dynamics NAV Server service regardless of whether that service is associated with an SPN.

For more information about SPNs, see How To: Set Up Delegation.

Default: false

OpenConnectionTimeout

The maximum amount of time to wait before determining that the client attempt to connect to Microsoft Dynamics NAV Server has failed.

Time span format: [dd.]hh:mm:ss[.ff]

Where:

  • dd: days

  • hh: hours

  • mm: minutes

  • ss: seconds

  • ff: fractions of a second

You can also use MaxValue to indicate no timeout.

Default: 00:00:30

UnknownSpnHint

This is a parameter the RoleTailored client can use to establish connections more quickly. Do not modify this parameter.

UrlHistory

A comma-delimited list of servers that is displayed in the Select Server window when you click the drop-down arrow in the Server name field.

This parameter is not present after you install the RoleTailored client, but it is created and populated once the user enters a server name in the field.

You can create and populate this field after installing the RoleTailored client. This gives the user a list of servers from which to choose.

Example:

  CopyCode imageCopy Code
<add key="UrlHistory" value="localhost, dev:7046/DynamicsNAV, sales:7046/DynamicsNAV"/>

FilterAsYouTypeAutomaticLookupEnabled

This setting is not present by default in the ClientUserSettings.config file. If you need to set this parameter, then you must first add it manually.

The filter-as-you-type (or find-as-you-type) feature displays a drop-down list of available choices as you type text into a field in the RoleTailored client. Some users may find this feature distracting or counterproductive, such as if the drop-down list appears whenever the user pauses when typing. To disable this feature, edit the ClientUserSettings.config file to add this parameter with a value of false:

  CopyCode imageCopy Code
<add key="FilterAsYouTypeAutomaticLookupEnabled" value="false"></add>

See Also