Data Director Connection Strings
This shows several examples of connection strings that you can use in your setup. In most cases it is just a matter of copying the string shown and changing the database name, user, and password.
The DD connection string consists of three sections: database-specific connection string, database type, and database-specific string. These three parts are separated by the “|” symbol. Each section is configured with parameters that can be different for each database type.
Syntax: <database connection string>|<database type id>|<database specific string>
Supported database types are:
Types | Specific Str | Description |
---|---|---|
fin | ndbcn@xxx | CFront for Native NAV Database (xxx is version ID) |
fin | ndbcs@xxx | CFront for SQL NAV Database (xxx is version ID) |
mssql | none | Microsoft SQL Server Database |
mssql | schema=xxx | Microsoft SQL Server Database with different schema name for table than default dbo |
ms | navxx | Direct SQL access to NAV SQL Database not using CFront (xx is the NAV version number) |
ms | bc | Direct SQL access to BC SQL Database |
lsws | none | LS Central Web Service v1 |
file | none | Export/Import Data to/from file Tab delimited with txt extension |
file | xxx@d | Export/Import Data to/from file (xxx is the file extension and d is tab delimiter character) |
xml | none | Export/Import Data to/from XML file (values as Elements) |
xml | attr | Export/Import Data to/from XML file (values as Attributes) |
oledb | none | OleDB access to Database |
odbc | none | ODBC access to Database |
mysql | none | MySQL Database Server |
ax | none | Microsoft Dynamic AX 2009 Database |
ax | 2012 | Microsoft Dynamic AX 2012 Database |
DD knows how to process connection strings designed for one type of database and use them to connect to a different type of database. For example, a NAV native connection string can be used to connect to an SQL database, as DD knows different commands for each item in the connection string.
These are the commands that DD understands for connection string item:
Database Server: | server, data source, address, network address |
Database Name: | initial catalog, database, dbname, datapath |
Database User Name: | user id, user, uid |
Database User Password: | passwd, password, pwd |
Database Security Mode: | integrated security, trusted_connection |
Network Library | nt, net, network library |
LS Location id: | locationid, id |
LS Central Company Name | company |
NAV 2013 and later Additional Object replication commands for finsql process:
navservername | navsrv |
navserverinstance | navinst |
navservermanagementport | navport |
tenant | navten |
synchronizeschemachanges | navsync |
AX special connection string commands:
provider | |
domain | |
language | |
cfg | |
object_server | |
port |
For information on how to put together a connection string for your database, see http://www.connectionstrings.com/. This site has samples of the most common database servers and data providers out there.
If a connection string does have some special features that do not fit the current rules that DD expects, then put “cust” in <database specific string> value and DD will use the connection string as is without trying to process it.
The following are examples of connection strings:
-
Microsoft SQL Server – Standard Connection
Initial Catalog=mydata;Data Source=myserver;User ID=dd;Password=ddpwd;|mssql|none
-
Microsoft SQL Server – Trusted Connection
Initial Catalog=mydata;Data Source=myserver;Integrated Security=SSPI;|mssql|none
-
Microsoft SQL Server – Trusted Connection with user login
Initial Catalog=mydata;Data Source=myserver;Integrated Security=SSPI;User=domain\dd; Password=ddpwd;|mssql|none
-
Microsoft Dynamics NAV Native Server – Standard Connection
company=mycompany;server=myserver;user=dd;passwd=ddpwd;|fin|ndbcn@602
-
Microsoft Dynamics NAV SQL Server – Standard Connection
company=mycompany;server=myserver;user=dd;passwd=ddpwd;|fin|ndbcs@602
-
Microsoft Dynamics NAV SQL Server – Trusted Connection
company=mycompany;server=myserver;|fin|ndbcs@602
-
Microsoft Dynamics NAV 201x – Standard Connection
company=mycompany;Initial Catalog=mydata;Data Source=myserver;User ID=dd;Password=ddpwd;|ms|nav80
-
Microsoft Dynamics NAV 201x – Trusted Connection
company=mycompany;Initial Catalog=mydata;Data Source=myserver;Integrated Security=SSPI;|ms|nav80
-
Microsoft Dynamics NAV 201x – Server Tier/Instance for FOB import
company=mycompany;Initial Catalog=mydata;Data Source=myserver;Integrated Security=SSPI;navsrv=myserver;navten=mytenant;navport=7045;navinst=myinstance;|ms|nav80
-
Microsoft Dynamics 365 Business Central – LS Web Service v1
company=mycompany;server=http://myserver:7047/BC130/WS/mycompany/Codeunit/RetailWebServices;user=nav;passwd=navpwd;|lsws|non
-
Microsoft Dynamics AX 2009 – Standard Connection
user=dd;passwd=ddpwd;domain=retail;company=lsr;object_server=LSRetail@server:2713;cfg=;|ax|none
-
Microsoft Dynamics AX 2009 – Trusted Connection
user=dd;company=lsr;object_server=LSRetail@server:2713;cfg=;|ax|none
-
OleDB – Standard Connection
Provider=SQLOLEDB;Initial Catalog=mydata;Data Source=myserver;User Id=dd;Password=ddpwd;|oledb|none
-
ODBC – Standard Connection
Provider=SQLOLEDB;Initial Catalog=mydata;Data Source=myserver;User Id=dd;Password=ddpwd;|odbc|none
-
Semicomma separated File Import / Export
Database=mydatafolderpath;|file|csv@;
-
XML File Import / Export
Database=myxmlfolderpath;|xml|none