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 Exact Online 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.exactonline.ExactOnlineDriver

• Provide the JDBC URL. For example:
  

  jdbc:exactonline:InitiateOAuth=GETANDREFRESH;Region='United States';Division=5512;
  
  or
  
  jdbc:cdata:exactonline:InitiateOAuth=GETANDREFRESH;Region='United States';Division=5512;

  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:exactonline:" or "jdbc:cdata:exactonline:" and can include any of the connection properties in name-value pairs separated with semicolons.

OAuth

See Using OAuth Authentication for an authentication guide.

You can connect without setting any connection properties for your user credentials.

After setting the following connection properties, you are ready to connect:

• Region: Set to the region of the Exact Online service you want to connect to.
• Division: Set to the division of the Exact Online administration.

When you connect, the driver opens the Exact Online OAuth endpoint in your default browser. Log in and grant permissions to the driver. The driver then completes the OAuth process.

1. Extracts the access token from the callback URL and authenticates requests.
2. Obtains a new access token when the old one expires.
3. Saves OAuth values in OAuthSettingsLocation to be persisted across connections.

See Using OAuth Authentication for other OAuth authentication flows. In this OAuth flow, you can connect without setting any connection properties for your user credentials. After setting the following connection properties, you are ready to connect:

• Region: Set to the region of the Exact Online service you want to connect to.
• Division: Set to the division of the Exact Online administration.

Click Connect and the driver opens the Exact Online OAuth endpoint. Log in and grant permissions to the driver. The driver then completes the OAuth process.