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 |
---|---|---|
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) and only to be used for NAV version 11 and older |
ms | bc | Direct SQL access to BC/365 SQL Database |
lsws | none | LS Central SaaS Web Service v1 |
lsws | s2s | LS Central SaaS Web Service v1 using oAuth (S2S) for authentication. This is used to access LS Central in Microsoft SaaS enviroment. |
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 |
ext | External Data Processing using DDDatabaseExt process. |
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-2018 Additional Object replication commands for finsql process:
navservername | navsrv |
navserverinstance | navinst |
navservermanagementport | navport |
tenant | navten |
synchronizeschemachanges | navsync |
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 Dynamics 365 BC – LS Central Web Service v1
company=mycompany;server=http://myserver:7047/BC130/WS/mycompany/Codeunit/RetailWebServices;user=nav;passwd=navpwd;|lsws|none
-
Microsoft Dynamics 365 BC – SaaS
server=http://myserver.dynamics.com/Production/WS/mycompany/Codeunit/RetailWebServices;user=ClientId;passwd=ClientSecret;Database=TenantId;|lsws|s2s
-
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 BC – Standard Connection
company=mycompany;Initial Catalog=mydata;Data Source=myserver;User ID=dd;Password=ddpwd;|ms|bc
-
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
-
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