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.
By default, finsql.exe is located at C:\Program Files (x86)\Microsoft Dynamics NAV\80\RoleTailored Client\.
Finsql.exe Command Syntax
The finsql.exe has the following syntax.
Copy Code | |
---|---|
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=<>,] [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>] |
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 |
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:
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. | 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:
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. | |||||
filter | A filter on the Object table. Use this parameter to specify which objects the command applies to. | |||||
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:
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:
| |||||
langid | Specifies the standard Windows three-letter ID of the language. | |||||
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. | |||||
navserverinstance | Specifies the Microsoft Dynamics NAV Server instance that is being used, such as DYNAMICSNAV72. | |||||
navservermanagementport | Specifies the port on the Microsoft Dynamics NAV Server that the Microsoft Dynamics NAV Windows PowerShell cmdlets access, such as 7045. | |||||
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:
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:
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. | |||||
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.
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 |