Manage Reckon Accounts Hosted Data in DBArtisan as a JDBC Source

The CData JDBC Driver for Reckon Accounts Hosted seamlessly integrates Reckon Accounts Hosted data into database management tools like DBArtisan by enabling you to access Reckon Accounts Hosted data as a database. This article shows how to create a JDBC source for Reckon Accounts Hosted in DBArtisan. You can then edit data visually and execute standard SQL.

Integrate Reckon Accounts Hosted Data into DBArtisan Projects

Follow the steps below to register Reckon Accounts Hosted data as a database instance in your project:

1. In DBArtisan, click Data Source -> Register Datasource.
2. Select Generic JDBC.
3. Click Manage.
4. In the resulting dialog, click New. Enter a name for the driver and click Add. In the resulting dialog, navigate to the driver JAR. The driver JAR is located in the lib subfolder of the installation directory.
5. In the Connection URL box, enter credentials and other required connection properties in the JDBC URL.

   The connector makes requests to Reckon Accounts Hosted through OAuth. Specify the following connection properties:

   • SubscriptionKey: Required. You get this value when you created your developer account.
   • CountryVersion: Defaults to 2021.R2.AU.
   • CompanyFile: Required. The path to the company file.
   • User: Required. The username of the company file.
   • Password: Required. The password of the company file.
   • InitiateOAuth: Set this to GETANDREFRESH to let the driver handle access tokens.
   • CallbackURL: The redirectURI of your Custom OAuth App.
   • OAuthClientId: The client id of your Custom OAuth App.
   • OAuthClientSecret: The client secret of your Custom OAuth App.

   CData provides an embedded OAuth application that simplifies OAuth desktop authentication. See the Help documentation for information on other OAuth authentication methods (web, headless, etc.), creating custom OAuth applications, and reasons for doing so.

   Built-in Connection String Designer

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

   java -jar cdata.jdbc.reckonaccountshosted.jar

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

   Below is a typical connection string:

   jdbc:reckonaccountshosted:SubscriptionKey=my_subscription_key;CountryVersion=2021.R2.AU;CompanyFile=Q:/CompanyName.QBW;User=my_user;Password=my_password;CallbackURL=http://localhost:33333;OAuthClientId=my_oauth_client_id;OAuthClientSecret=my_oauth_client_secret;InitiateOAuth=GETANDREFRESH
6. Finish the wizard to connect to Reckon Accounts Hosted data. Reckon Accounts Hosted entities are displayed in the Datasource Explorer.

You can now work with Reckon Accounts Hosted data as you work with any other database. See the driver help documentation for more information on the queries supported by the Reckon Accounts Hosted API.