VOOZH about

URL: https://www.cdata.com/kb/tech/workday-jdbc-knime.rst

⇱ Enable the Workday JDBC Driver in KNIME

Enable the Workday JDBC Driver in KNIME

👁 Dibyendu Datta
Dibyendu Datta
Lead Technology Evangelist
Use standard data access components in KNIME to create charts and reports with Workday data.

One of the strengths of the CData JDBC Driver for Workday is its cross-platform support, enabling integration with major BI tools. Follow the procedure below to access Workday data in KNIME and to create a chart from Workday data using the report designer.

About Workday Data Integration

CData provides the easiest way to access and integrate live data from Workday. Customers use CData connectivity to:

  • Access the tables and datasets you create in Prism Analytics Data Catalog, working with the native Workday data hub without compromising the fidelity of your Workday system.
  • Access Workday Reports-as-a-Service to surface data from departmental datasets not available from Prism and datasets larger than Prism allows.
  • Access base data objects with WQL, REST, or SOAP, getting more granular, detailed access but with the potential need for Workday admins or IT to help craft queries.

Users frequently integrate Workday with analytics tools such as Tableau, Power BI, and Excel, and leverage our tools to replicate Workday data to databases or data warehouses. Access is secured at the user level, based on the authenticated user's identity and role.

For more information on configuring Workday to work with CData, refer to our Knowledge Base articles: Comprehensive Workday Connectivity through Workday WQL and Reports-as-a-Service & Workday + CData: Connection & Integration Best Practices.


Getting Started


Define a New JDBC Connection to Workday Data

  1. Go to File -> Preferences -> KNIME -> Databases
  2. Click Add File and add the cdata.jdbc.workday.jar. The driver JAR file is located in the lib subfolder of the installation directory. 👁 CData drivers added to a KNIME workflow.
  3. Click Find driver classes
  4. Set the ID and the Name of the connection (you can set any values you prefer for these fields as they are not restricted)
  5. Set the URL template. A typical JDBC URL is provided below: 
    	 jdbc:workday:User=myuser;Password=mypassword;Tenant=mycompany_gm1;BaseURL=https://wd3-impl-services1.workday.com;ConnectionType=WQL;InitiateOAuth=GETANDREFRESH;

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

    	java -jar cdata.jdbc.workday.jar
    👁 Connection properties added to CData driver

    Additionally, please refer to our documentation to learn more about Connection Properties

  6. Click OK to close the configuration section. 👁 Registering new database CData drivers in KNIME workflow.
  7. Under Node Repository go to DB -> Connection -> drag and drop DB Connector. Double-click on it and change the driver name to the driver you just configured, in this case, Workday (ID: Workday). The Database URL should change automatically. 👁 Configuring the CData driver
  8. Click Apply and OK to save changes. 👁 Authentication
  9. Right-click on the connector and select Execute. You will see that the connector will allow you to redirect to the browser where you will need to log in and allow access. After that, you will get connected successfully. 👁 Executing the DB Connector

    10. Now you can go to the Read/Write section in Node Repository and get a DB Query Reader, to be able to execute a query. 👁 DB Query Reader

  10. Double-click on your DB Query Reader and click the refresh button to load the metadata. Create an SQL Statement and click Evaluate. After clicking Evaluate you will be able to see the records requested. To learn more about the tables/views that are listed in our driver please refer to our Data Model. 👁 DB Query Reader to load the metadata

Get Started Today

Download a free, 30-day trial of the CData JDBC Driver for Workday and start building Workday-connected charts and reports with KNIME. Reach out to our Support Team if you have any questions.