Overview
This connector allows you to analyze your ZenGRC data using Tableau. The connector uses the ZenGRC API and pulls fields based on that. For additional information on those fields, please see our documentation at https://docs.api.zengrc.com/
Accessing Tableau Integration
NOTE
To access connectors, please see Introduction to ZenConnect.
Create a New API Key and Secret
To set up the initial connection, you must first generate an API key, which can be done within ZenGRC.
To create a new API key and secret, complete the following steps:
- Click Developer settings within the text on the Settings | Tableau page.
OR access the ZenGRC Developers page directly by clicking Settings | Developers.
Follow the instructions at ZenGRC Cloud API under Generate the Key ID and Key Secret. Then continue with the next section.
Add New Web Data Connector in Tableau
After generating the key and key secret, complete the following steps:
- On the Settings | Tableau page, copy the URL from the box as shown in the screenshot below.
- Open Tableau Desktop on your computer.
- Click Web Data Connector and paste the URL you copied above.
- Paste the key ID and key secret in the applicable text boxes.
- Click Sign in.
- Once signed into Tableau, the connection displays ZenGRC tables. Through drag and drop, the view allows joins and data analysis. Please see the Tableau website for more information.
ZenGRC Objects and Relationships
The following table shows the objects available in Tableau, along with any bridge tables and other considerations:
| Available Objects | Custom Attributes | Bridge Tables | Special Considerations |
|---|---|---|---|
| Assessments | Not supported | Assessments to Audits | No |
| Audits | Not supported | Assessments to Audits, Issues to Audits, | Program ID in Audits table = ID in Programs table, Audit ID in the Requests table = ID in the Audits table |
| Issues | Not supported | Issues to Audits, Requests to Issues | No |
| Programs | Not supported | Requests to Programs, | Program ID in Audits table = ID in Programs table |
| Projects | Not supported | No | No |
| Requests | Not supported | Requests to Issues | Audit ID in the Requests table = ID in the Audits table |
| Risks | Not supported | No | Risk scores not yet supported |
| Systems | Not supported | No | No |
| Tasks | Not supported | No | No |
| Vendors | Not supported | No | No |
Bridge Tables
A bridge table in Tableau allows you to join two tables to more easily pull information most relevant to your organization. The following screenshot displays a bridge table in Tableau. It is an example of how the "Assessments to Audits" bridge table connects the Audits and Assessments tables:
