Visualize Zoho Recruit Data in Sisense

Jerod Johnson
Director, Technology Evangelism

Create an ElastiCube in Sisense app with access to Zoho Recruit data.

Sisense lets you join, analyze, and picture data to make more intelligent business decisions and craft effective strategies. The CData API Driver for JDBC makes it easy to integrate with Zoho Recruit data in Sisense. This article shows how to create an ElastiCube that connects to Zoho Recruit data and use the ElastiCube to visualize Zoho Recruit data in Sisense.

Configure the Connection to Zoho Recruit

Before creating the ElastiCube, note the installation location for the JAR file for the JDBC Driver (typically C:\Program Files\CData\CData API Driver for JDBC 20XX\lib) or copy the jar file (cdata.jdbc.api.API.jar) to a new folder in the Sisense JDBC driver directory (typically C:\ProgramData\Sisense\DataConnectors\jdbcdrivers).

In the Data page of the Sisense application, create a new ElastiCube (or open an existing one).
In the Model Editor, click "+ Data" to open the Add Data dialog box.
Click Generic JDBC to open the JDBC settings.
Set the connection string property to the JDBC URL for Zoho Recruit, adding required properties.
To authenticate to ZohoRecruit, and connect to your own data or to allow other users to connect to their data, you can use the OAuth standard.

Using OAuth Authentication

First, you will need to register an OAuth application with ZohoRecruit. To do so, go to the Zoho Developer Console, add a new Client (Server-based application) and set a valid OAuth redirect URL. Your OAuth application will be assigned a client id and a client secret. Additionally, you will need to set the relevant Domain (.com, .eu, .in, .com.cn, or .jp), which defaults to .com.

After setting the following connection properties, you are ready to connect:
- AuthScheme: Set this to OAuth.
- InitiateOAuth: Set this to GETANDREFRESH. You can use InitiateOAuth to manage the process to obtain the OAuthAccessToken.
- OAuthClientId: Set this to the client_id that is specified in your app settings.
- OAuthClientSecret: Set this to the client_secret that is specified in your app settings.
- CallbackURL: Set this to the Redirect URI that is specified in your app settings.
- Domain: Set this in ProfileSettings to your ZohoRecruit account domain (e.g. .com, .eu, .in, .com.cn, .jp).
Example connection string:
```
Profile=C:\profiles\ZohoRecruit.apip;ProfileSettings='Domain=.com';AuthScheme=OAuth;InitiateOAuth=GETANDREFRESH;OAuthClientId=your_client_id;OAuthClientSecret=your_client_secret;CallbackUrl=your_callback_url;
```
Built-in Connection String Designer

For assistance in constructing the JDBC URL, use the connection string designer built into the Zoho Recruit JDBC Driver. Either double-click the JAR file or execute the jar file from the command-line.
```
java -jar cdata.jdbc.api.jar
```
Fill in the connection properties and copy the connection string to the clipboard.

When you configure the JDBC URL, you may also want to set the Max Rows connection property. This will limit the number of rows returned, which is especially helpful for improving performance when designing reports and visualizations.

A typical example follows:
```
jdbc:api:Profile=C:\profiles\ZohoRecruit.apip;ProfileSettings='Domain=.com';AuthScheme=OAuth;InitiateOAuth=GETANDREFRESH;OAuthClientId=your_client_id;OAuthClientSecret=your_client_secret;CallbackUrl=your_callback_url;
```
Set the JDBC JARs folder property to the location of the CData JDBC Driver JAR file (see above).
Set the driver's class name to the class name for the JDBC Driver: cdata.jdbc.api.APIDriver
Leave the username and password properties blank.
Click Next.

Add Zoho Recruit Data to an ElastiCube

Once you are connected to Zoho Recruit, you can add views to your ElastiCubes.

From the Tables list, select the tables and/or views you wish to work with.
(Optional) Click "+" to customize the data you want to import with SQL.
Click Done.
Click Build to build the ElastiCube for analytics.