Using the Development Environment from the Command Prompt

You can start the Microsoft Dynamics NAV Development Environment by running finsql.exe at the command prompt. You can also use the finsql.exe command to perform the following development tasks without using the development environment:

  • Create databases

  • Upgrade databases

  • Compile objects

  • Delete objects

  • Export objects

  • Import objects

  • Export language modules

  • Import language modules

  • Export text strings for translation

  • Import translated text strings

  • Build metadata for application objects.

  • Set the object cache.

  • Set the temporary file location.

  • Set the path and file name of the ZUP file for storing setup parameters.

  • Get the Microsoft Dynamics NAV build version.

By default, finsql.exe is located at C:\Program Files (x86)\Microsoft Dynamics NAV\90\RoleTailored Client\.

Finsql.exe Command Syntax

The finsql.exe has the following syntax.

Finsql.exe [command=<command> | designobject=<object type> <object ID>,] [servername=<server>,] [database=<database>,] [collationname=<collation>,] [file=<file>,] [filter=<filter>], [importaction=<default|overwrite|skip|0|1|2>,] [langid=<ID>,] [logfile=<logfile>,] [navservername=<name>,] [navserverinstance=<instance>,] [navservermanagementport=<port>,] [ntauthentication=<yes|no|0|1>,] [objectcache=<cache>,] [password=<password>,] [temppath=<path>,] [tenant=<tenant ID>,] [username=<user name>,] [synchronizeschemachanges=<yes|no|force>, ] [useoldeditor=<yes|no>]

Syntax Key

The following table describes the notation that is used to indicate syntax.

Notation Description

Text without brackets

Parameters that you must type as shown.

<>

A placeholder for values that you must supply. Do not include the brackets in the value.

[ ]

Optional parameters. Do not include the brackets.

|

A set of values from which to choose. Use one of the options and do not include | in the value.

Information about building commands

  • The parameters that you use will depend on the command that you are running as determined by the command and designobjects parameters.

  • You can place parameters in any order after finsql.exe.

Finsql.exe Parameters

The following table describes the parameters that you can use with finsql.exe.

Parameter Description Related command

collation

The collation to use when you create a new database. The value must be one of the following:

  • A full language culture name. For example, da-DK for Danish or hu-HU for Hungarian.

  • A SQL Server collation name without case or accent. For example, Latin1_General_100.

  • A SQL Server collation name with case and accent. For example, Danish_Greenlandic_100_CS_AI.

Use this optional parameter when you create a database with the command=createdatabase parameter.

CreateDatabase

command

The development command that you want to run. The possible values are as follows:

If you specify this parameter and run a command, then the development environment does not open.

Not applicable

database

If you use the command=CreateDatabase parameter, then the database parameter specifies the name of the new database that you want to create. In this case, the database parameter is required.

For all other commands, the database parameter specifies the database that you want to open.

If you do not specify both the servername and the database parameter, then the database server and database that are stored in the .zup file are used. If you do not specify the database parameter but you do specify the servername parameter, then the Open Database window opens so that you can specify the database name.

For more information, see Saving Setup Parameters in the Zup File.

All

designobject

The type and ID of the object that you want to design. The possible values of the object type are as follows:

  • Table

  • Page

  • Report

  • Codeunit

  • Query

  • XMLport

The possible values of the object ID are 0 and any ID of an existing object. If you specify 0 for the object ID, then you open a new object to design.

For more information, see DesignObject.

Not applicable

file

The path and file name of the file that is used exporting data to or importing data from . The file type depends on the command.

CreateDatabase

ExportObjects

ImportObjects

ExportLangModule

ImportLangModule

ExportTranslate

ImportTranslate

filter

A filter on the Object table.

Use this parameter to specify which objects the command applies to.

CompileObjects

CreateLanguage

ExportObjects

ExportTranslate

id

Specifies the path and file name of the .zup file for storing setup parameters. By default, the setup parameters are stored in and retrieved from the fin.zup file. If you specify the id parameter, then the setup parameters are stored in and retrieved from a file that is named <id>.zup.

By default, the fin.zup file is located at C:\users\<user name>\AppData\Roaming\. To change the location of the .zup file, specify the path and ID in the id parameter.

For example, the following command sets the path and file name of the .zup file to C:\mynavfin.zup:

finsql.exe id="C:\mynavfin.zup"

For more information, see Saving Setup Parameters in the Zup File.

None. You use this as a stand-alone parameter with the finslg.exe.

importaction

Specifies how to handle conflicts with existing objects when you import from a .fob file. The possible values are:

  • default or 0 (default) – If there is a conflict, then an error is logged in the log file and no objects from the file are imported.

  • overwrite or 1 – If there is a conflict, then overwrite the existing object with the object in the import file.

  • skip or 2 - If there is a conflict, then skip the object. The existing object remains unchanged.

ImportObjects

langid

Specifies the standard Windows three-letter ID of the language.

CreateLanguage

ExportLangModule

logfile

Specifies the path and file name for the file that contains error messages that result from running finsql.exe with the command parameter. If there are no errors, then a log file is not created.

All

navservername

Specifies the name of the server that hosts the Microsoft Dynamics NAV Server instance, such as MyServer.

CompileObjects

DeleteObjects

ImportObjects

navserverinstance

Specifies the Microsoft Dynamics NAV Server instance that is being used, such as DynamicsNAV90.

CompileObjects

DeleteObjects

ImportObjects

navservermanagementport

Specifies the port on the Microsoft Dynamics NAV Server that the Microsoft Dynamics NAV Windows PowerShell cmdlets access, such as 7045.

CompileObjects

DeleteObjects

ImportObjects

ntauthentication

Specifies if you want to use NT authentication. The possible values are yes, no, 1, or 0. If you specify the username and password parameters, then you must specify ntauthentication=no or ntauthentication=0.

All

objectcache

Specifies the size of the object cache, in kilobytes. Objects such as code, descriptions, and windows that are used on the computer that is running the development environment are stored in the object cache.

The default value is 32000.

For example, the following command sets the object cache to 50000:

finsql.exe objectcache=50000 

You can also set the object cache from the Options window in the Tools menu of the development environment. For more information, see Options,

None. You use this as a stand-alone parameter with the finsql.exe.

password

Specifies the password to use with the username parameter to authenticate to the database. If you do not specify a user name and password, then the command uses the Windows user name and password of the current user to authenticate to the database.

All

servername

Specifies the name of the database server.

If you do not specify both the servername parameter and the database parameter, then the database server and database that are stored in the .zup file are used. If you do not specify the servername parameter but you do specify the database parameter, then the Open Database window opens so that you can specify the database server name.

For more information, see Saving Setup Parameters in the Zup File.

All

temppath

Specifies the path of the location to store temporary files that are created while Microsoft Dynamics NAV runs. These files are automatically deleted when Microsoft Dynamics NAV is closed.

By default, these files are put in the Temp folder for the user, such as <C:\Users\<user name>\AppData\Local\Temp\>.

For example, the following command sets the temporary file path to C:\Temp:

finsql.exe temppath="c:\temp"

You can also set the temporary file path from the Options window in the Tools menu of the development environment. For more information, see Options,

None. You use this as a stand-alone parameter with the finsql.exe.

tenant

Specifies the ID of the tenant that is accessed when you run objects from the development environment. If your solution is not set up to deploy in a multitenant deployment architecture, leave the parameter empty.

CompileObjects

DeleteObjects

ImportObjects

useoldeditor

Specifies whether to use the C/AL Editor that was available in Microsoft Dynamics NAV 2015 and earlier versions. The C/AL Editor was redesigned in Microsoft Dynamics NAV 2016.

To use the old editor, specify the parameter as useoldeditor=yes or useoldeditor.

To use the new editor, omit the parameter or specify it as useoldeditor=no.

None. This parameter is not relevant when you use command because the development environment does not open.

username

The user name to use to authenticate to the database. The user name must exist in the database. If you do not specify a user name and password, then the command uses the Windows user name and password of the current user to authenticate to the database.

JJ863505.Warning(en-us,NAV.90).gifWarning
If User Access Control (UAC) is turned on and you do not specify to run the Command Prompt window as Administrator, then the Command Prompt window runs as a standard user. In this case, if you do not specify the username parameter and the current Windows user is an Administrator, then the command is run as the standard user.

If you specify the username parameter, then you must also specify the password parameter and the ntauthentication parameter must be no or 0.

For more information about database users and permissions, see Setting Database Owner and Security Administration Permissions.

All

See Also

Concepts

Development Environment Commands
Saving Setup Parameters in the Zup File
Designing Application Objects