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
Export objects
Import objects
By default, finsql.exe is located at C:\Program Files (x86)\Microsoft Dynamics NAV\71\RoleTailored Client\.
Finsql.exe [command=<command> | designobject=<object type> <object ID>,] [servername=<server>,] [database=<database>,] [collationname=<collation>,] [file=<file>,] [filter=<filter>], [logfile=<logfile>,] [username=<user name>,] [password=<password>,] [ntauthentication=<yes|no|0|1>]
Finsql.exe Parameters
The following table describes the parameters that you can use with finsql.exe.
Parameter | Description |
---|---|
collation |
The collation to use when you create a new database. The value must be one of the following:
Use this optional parameter when you create a database with the command=createdatabase parameter. |
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. For more information, see Development Environment Commands. |
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. |
designobject |
The type and ID of the object that you want to design. The possible values of the object type are as follows:
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. |
file |
The path and file name. Use the file parameter for the following:
For more information, see ExportObjects and ImportObjects. |
filter |
A filter on the Object table. Use this parameter if you use the command parameter to compile, export, or import objects. For more information, see Development Environment Commands. |
id |
Specifies the ID of the .zup file. 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 more information, see Saving Setup Parameters in the Zup File. |
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. For more information, see Development Environment Commands. |
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. |
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. |
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. |
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. |
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\>. |
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.
Warning
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. |
See Also
Concepts
Development Environment Commands
Saving Setup Parameters in the Zup File
Designing Application Objects