Integrating Workday Data in Talend Cloud Data Management Platform

Qlik's Talend Cloud Data Management Platform supports various data environments, enabling analytics for smarter decisions, operational data sharing, data and application modernization, and establishing data excellence for risk reduction. When paired with the CData JDBC Driver for Workday, you can improve data integration, quality, and governance for your Workday Data. This article shows how you can easily integrate to Workday using a CData JDBC Driver in Talend Cloud Data Management, and then view the data for simultaneous use in your workflow.

Getting Started

---

Prerequisites

Before connecting the CData JDBC Driver to view and work with your data in Talend Cloud Data Management Platform, make sure to download and install the latest version of Talend Studio on your system. Also, ensure that you have the required prerequisites.

1. A Talend Cloud Data Management account with appropriate permissions.
2. The CData JDBC Driver for Workday, which can be downloaded from the CData website.

Connect to Workday in Talend as a JDBC data source

Access Talend Data Management Cloud

1. Run the Talend Cloud Data Management Platform installed on your local system and click on Other Login Mode.
2. Click on Manage Connections. Set Repository to "Local" and enter the Name, Description and User E-mail in the respective spaces. Set the Workspace path and click on OK.
3. Now, select the Create a new project radio button to add a new project name and click on Create.
4. The new project should appear under the Select an existing project section. Click on Open. The Talend Cloud Data Management Platform workspace opens up.

Create a new connection

1. In the navigation pane, locate and expand the Metadata dropdown. Right-click on Db Connections and select Create Connection.
2. Search for and select 'JDBC' in the Find section of the Database Connection window. Then, click on Finish.
3. Enter the Name, Purpose and Description of the new database in Talend where you need to load the Workday data. Click on Next.

4. Generate a JDBC URL for connecting to Workday, beginning with jdbc:workday: followed by a series of semicolon-separated connection string properties.

   To connect to Workday, users need to find the Tenant and BaseURL and then select their API type.

   Obtaining the BaseURL and Tenant

   To obtain the BaseURL and Tenant properties, log into Workday and search for "View API Clients." On this screen, you'll find the Workday REST API Endpoint, a URL that includes both the BaseURL and Tenant.

   The format of the REST API Endpoint is: https://domain.com/subdirectories/mycompany, where:

   • https://domain.com/subdirectories/ is the BaseURL.
   • mycompany (the portion of the url after the very last slash) is the Tenant.
   For example, in the REST API endpoint https://wd3-impl-services1.workday.com/ccx/api/v1/mycompany, the BaseURL is https://wd3-impl-services1.workday.com and the Tenant is mycompany.

   Using ConnectionType to Select the API

   The value you use for the ConnectionType property determines which Workday API you use. See our Community Article for more information on Workday connectivity options and best practices.

   API	ConnectionType Value
   WQL	WQL
   Reports as a Service	Reports
   REST	REST
   SOAP	SOAP

   
   

   Authentication

   Your method of authentication depends on which API you are using.

   • WQL, Reports as a Service, REST: Use OAuth authentication.
   • SOAP: Use Basic or OAuth authentication.

   See the Help documentation for more information on configuring OAuth with Workday.

   Built-in Connection String Designer

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

   java -jar cdata.jdbc.workday.jar

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

   A typical JDBC URL is below:

   jdbc:workday:User=myuser;Password=mypassword;Tenant=mycompany_gm1;BaseURL=https://wd3-impl-services1.workday.com;ConnectionType=WQL;InitiateOAuth=GETANDREFRESH

5. Enter the JDBC URL copied from CData JDBC Driver for Workday in Edit new database.

6. Click on the "(+) Add" button under Drivers. A 'newLine' will appear in the Drivers board. Click on (...) at the end of the new line, select the Install a new module radio button, and click on (...) to add the path to the JAR file, located in the 'lib' subfolder of the installation directory. Click on OK.
7. Select the Driver Class as cdata.jdbc.workday (JAR file obtained from your installation directory given in the previous step).

Test the new connection

1. Click on Check Connection. If the entered details are correct, a "Connection successful" confirmation prompt will appear. Click on "OK" and "Finish".
2. Once the connection is established, right-click on the newly created connection and select Retrieve Schema. You can use the filters as well to retrieve the data as per your requirements. Click on Next.
3. Expand the "CData" catalog in the Schema window and select the tables you want to import from the Workday schema. Click on Next.
4. In the next step, select the columns you want to view from the table and click on Finish.
5. All the selected tables from the Workday schema are now populated under the Table Schemas section of the JDBC connection.
6. Right-click on any of the selected tables and click on Data Viewer to preview the data from the data source.

Get Started Today

Download a free, 30-day trial of the CData JDBC Driver for Workday and integrate Workday data into Talend Cloud Data Management Platform. Reach out to our Support Team if you have any questions.