Ready to get started?

Learn more about the CData JDBC Driver for Dynamics GP or download a free trial:

Download Now

Connect to Dynamics GP Data in JRuby

Create a simple JRuby app with access to live Dynamics GP data.

JRuby is a high-performance, stable, fully threaded Java implementation of the Ruby programming language. The CData JDBC Driver for Dynamics GP makes it easy to integrate connectivity to live Dynamics GP data in JRuby. This article shows how to create a simple JRuby app that connects to Dynamics GP data, executes a query, and displays the results.

Configure a JDBC Connection to Dynamics GP Data

Before creating the app, note the installation location for the JAR file for the JDBC Driver (typically C:\Program Files\CData\CData JDBC Driver for Dynamics GP\lib).

JRuby natively supports JDBC, so you can easily connect to Dynamics GP and execute SQL queries. Initialize the JDBC connection with the getConnection function of the java.sql.DriverManager class.

To authenticate set the User and Password connection properties.

To connect set the URL to the Web services endpoint; for example, http://{servername}:{port}/Dynamics/GPService. Additionally, set CompanyId; you can obtain this value in the company setup window: Click Tools -> Setup -> Company.

By default, data summaries are not returned 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.

Built-in Connection String Designer

For assistance in constructing the JDBC URL, use the connection string designer built into the Dynamics GP JDBC Driver. Either double-click the JAR file or execute the jar file from the command-line.

java -jar cdata.jdbc.dynamicsgp.jar

Fill in the connection properties and copy the connection string to the clipboard.

Below is a typical JDBC connection string for Dynamics GP:

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

Create a JRuby App with Connectivity to Dynamics GP Data

Create a new Ruby file (for example: DynamicsGPSelect.rb) and open it in a text editor. Copy the following code into your file:

require 'java' require 'rubygems' require 'C:/Program Files/CData/CData JDBC Driver for Dynamics GP 2018/lib/cdata.jdbc.dynamicsgp.jar' url = "jdbc:dynamicsgp:CompanyId=mycompanyId;user=myuser;password=mypassword;URL= http://{servername}:{port}/Dynamics/GPService;" conn = java.sql.DriverManager.getConnection(url) stmt = conn.createStatement rs = stmt.executeQuery("SELECT CustomerName, TotalAmount FROM SalesInvoice") while (rs.next) do puts rs.getString(1) + ' ' + rs.getString(2) end

With the file completed, you are ready to display your Dynamics GP data with JRuby. To do so, simply run your file from the command line:

jruby -S DynamicsGPSelect.rb

Writing SQL-92 queries to Dynamics GP allows you to quickly and easily incorporate Dynamics GP data into your own JRuby applications. Download a free trial today!