Starting the RoleTailored Client from a Command Prompt

  • 2 minutes to read

You can start the RoleTailored client at a command prompt. By adding command-line parameters, you can:

  • Start the RoleTailored client with a profile other than the default profile.

  • Configure a profile.

  • Start the RoleTailored client with a language other than the default language.

  • Start the RoleTailored client with client settings other than the default client settings.

  • Start the RoleTailored client and open the specified page.

  • Start the RoleTailored client and open the specified report.

To run the RoleTailored client at a command prompt, open a command-prompt window and navigate to the RoleTailored client directory. The default location is:

Program Files\Microsoft Dynamics NAV\60\RoleTailored Client

The executable name is:

Microsoft.Dynamics.Nav.Client.exe

You can also start the RoleTailored client from the address bar in a browser or from a Run window using the same options. To start the RoleTailored client from a browser, type

DynamicsNAV://<Server/ServerInstance>/<Company>/

For example, to open the CRONUS International Ltd. company you could type

DynamicsNAV://localhost/DynamicsNAV/CRONUS%20International%20Ltd./

Command-Line Parameters

You can use the following parameters when you start the RoleTailored client at a command prompt.

Parameter Meaning

-?

Displays this list of parameters.

-profile:id

Starts the RoleTailored client with the specified profile.

Example

This command starts the RoleTailored client with the Accounting Manager profile:

Microsoft.Dynamics.Nav.Client.exe -profile:"Accounting Manager"

-configure

Starts the RoleTailored client in configuration mode. Use configuration mode to configure a profile. To specify which profile to configure, add the -profile parameter.

Example

This command starts the RoleTailored client in configuration mode for editing the Accounting Manager profile:

Microsoft.Dynamics.Nav.Client.exe -configure -profile:"Accounting Manager"

See How to: Configure a Role Center for details on configuring profiles.

-disablepersonalization

Personalization allows users to customize their Role Center and pages by showing or hiding elements such as actions, FactBoxes, FastTabs, and fields. When the RoleTailored client is started with -disablepersonalization, users are not able to personalize.

This parameter is only valid with Microsoft Dynamics NAV 2009 R2 and with Microsoft Dynamics NAV 2009 SP1 builds 31671 and higher.

-language:id

Starts the RoleTailored client with the specified language.

Examples

This command starts the RoleTailored client with locale ID 1033:

Microsoft.Dynamics.Nav.Client.exe -language:1033

This command starts the RoleTailored client for the culture named de-DE:

Microsoft.Dynamics.Nav.Client.exe -language:de-DE

-settings:file

Starts the RoleTailored client with the specified settings file.

For information on RoleTailored client settings files, see Configuring the RoleTailored Client.

Example

This command starts the RoleTailored client with a version of ClientUserSettings.Config that is not at the default location:

Microsoft.Dynamics.Nav.Client.exe -settings:"C:\AuxClientSettings\ClientUserSettings.config"

URL

Opens the RoleTailored client to a particular page or with a particular report.

Examples

This command starts the RoleTailored client and opens to page 21 (the Customer Card):

Microsoft.Dynamics.Nav.Client.exe "DynamicsNAV://<Server/ServerInstance>/Company/RunPage?Page=21"

This command starts the RoleTailored client and opens the request page for report 101 (the Customer List):

Microsoft.Dynamics.Nav.Client.exe "DynamicsNAV://<Server/ServerInstance>/Company/RunReport?Report=101"

This command runs the same report, assuming the default server, server instance, and company. This version runs from a browser instead of at a command prompt:

DynamicsNAV:////RunReport?Report=101

If you specify a Server and Server Instance, you must also specify a company. But you can specify a company without specifying a Server and Server Instance:

Microsoft.Dynamics.Nav.Client.exe "DynamicsNAV:///Company/RunReport?Report=101"

-failurestacktrace

Sends the stack trace for the RoleTailored client to Windows Clipboard.

See Also

Other Resources

Creating and Running Hyperlinks