Creating a JDBC Data Source

You can create a JDBC data source to connect from your Java application. Creating a JDBC data source based on the CData JDBC Driver for Microsoft Dynamics GP consists of three basic steps:

• Add the driver JAR file to the classpath. The JAR file is located in the lib subfolder of the installation directory. Note that the .lic file must be located in the same folder as the JAR file.
• Provide the driver class. For example:
  

  cdata.jdbc.dynamicsgp.DynamicsGPDriver

• Provide the JDBC URL. For example:
  

  jdbc:dynamicsgp:CompanyId=mycompanyId;user=myuser;password=mypassword;URL=http://{servername}:{port}/Dynamics/GPService
  
  or
  
  jdbc:cdata:dynamicsgp:CompanyId=mycompanyId;user=myuser;password=mypassword;URL=http://{servername}:{port}/Dynamics/GPService

  The second format above can be used whenever there is a conflict in your application between drivers using the same URL format to ensure you are using the CData driver. The URL must start with either "jdbc:dynamicsgp:" or "jdbc:cdata:dynamicsgp:" and can include any of the connection properties in name-value pairs separated with semicolons.

Connecting to Microsoft Dynamics GP

To connect set URL to the Web services endpoint; for example, http://{servername}:{port}/Dynamics/GPService. Additionally, set CompanyId to the unique identifier of the company you are connecting to. You can obtain this value by querying the Company table and leaving the property empty.

Authenticating to Microsoft Dynamics GP

The Microsoft Dynamics GP data source supports the following authentication methods:

• Anonymous Authentication
• WS-Security (WSS) Authentication
• Basic Authentication
• NTLM User Authentication
• Digest
• Negotiate (Kerberos)

Anonymous Authentication

In some situations, you can connect to Microsoft Dynamics GP without setting any authentication connection properties. To do so, set the AuthScheme to None, and you are ready to connect.

WS-Security (WSS)

Set the User and Password to connect and set AuthScheme to WSS.

Note: WSS Authentication is the default authentication scheme.

Basic

Set the User and Password to connect and set AuthScheme to Basic.

Windows (NTLM)

Set the Windows User and Password to connect and set AuthScheme to NTLM.

Digest

Set the User and Password to connect and set AuthScheme to Digest.

Kerberos

See Using Kerberos for details on how to authenticate with Kerberos.

Fine Tuning Data Access

The driver returns data summaries by default to save performance. Set LookupIds to true to return details such as line items; however, note that entities must be retrieved one at a time.