Connect to JD Edwards Data in Aqua Data Studio

The CData JDBC Driver for JD Edwards integrates JD Edwards data with wizards and analytics in IDEs like Aqua Data Studio. This article shows how to connect to JD Edwards data through the connection manager and execute queries.

Create a JDBC Data Source

You can use the connection manager to define connection properties and save them in a new JDBC data source. The JD Edwards data source can then be accessed from Aqua Data Studio tools.

1. In Aqua Data Studio, select Register Server from the Servers menu.
2. In the Register Server form, select the 'Generic - JDBC' connection.
3. Enter the following JDBC connection properties:
   • Name: Enter a name for the data source; for example, JD Edwards.
   • Driver Location: Click the Browse button and select the cdata.jdbc.jdedwards.jar file, located in the lib subfolder of the installation directory.
   • Driver: Enter the Driver's class name, cdata.jdbc.jdedwards.JDEdwardsDriver.

   • URL: Enter the JDBC URL, which starts with jdbc:jdedwards: and is followed by a semicolon-separated list of connection properties.

     The driver connects to JD Edwards through your Application Interface Services (AIS) Server. Set the following connection properties:

     • URL: The base HTTPS URL of your AIS Server (e.g., https://jde-ais.example.com:8300).
     • User: Your JD Edwards username.
     • Password: Your JD Edwards password.
     • Environment (optional): The JD Edwards environment to use (e.g., PD920 for production or DV920 for development). If not specified, the AIS Server's default environment is used.
     • Role (optional): The JD Edwards role for the session. If not specified, the AIS Server's default role is used.
     • DeviceName (optional): An identifier for the connecting device or application, used for auditing and logging on the AIS Server.
     • Jasserver (optional): The specific Java Application Server (JAS) instance to route requests through, useful in clustered environments.

     Choosing Which Data Is Exposed

     JD Edwards organizes tables and business views by System Code, and the driver exposes each System Code as its own schema. Use these properties to control which schemas are available:

     • DataModel: One or more ERP modules (comma-separated) whose System Codes are exposed as schemas, or All to expose every System Code in the connected instance. Defaults to FinancialManagement.
     • SystemCodes: A comma-separated list of additional System Codes to expose alongside those from DataModel (e.g., 42,43).

     When you connect, the driver sends your credentials to the AIS Server to obtain a session token and caches it. The driver requests a new token automatically before the session expires.

     Built-in Connection String Designer

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

     
     java -jar cdata.jdbc.jdedwards.jar
     

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

     A typical JDBC URL is below:

     jdbc:jdedwards:URL=https://your-jde-environment-app.example.com;User=admin;Password=myPassword;

   

Query JD Edwards Data

You can now query the tables exposed.