Overview
The Tableau Key Result integration allows users to leverage underlying data from a Tableau workbook to automatically update progress of a Key Result in WorkBoard.
Requirements
- The IT admin for your organization may need to approve the connector for the first time if the App is configured to require approval.
Frequently Asked Questions
What are Filter options based off?
Filter options are based off of values in the columns and rows shelf of a selected worksheet, not the section Filter Tableau section.
What is my content URL and where do I find it?
The content URL is the site name as it appears in the URL for your site, or for the view that you want to access. If you’re using the default site, there will be no site and you should leave this field empty. In all other cases, the content url is the URL text that immediately follows #/site/ in the URL. In the example given by Tableau in the url http://MyServer/#/site/MarketingTeam/projects the Site Name is “Marketing Team” and the content URL is “MarketingTeam” (note the lack of space).
If your URL doesn’t have the term /#/site/<content URL> then it’s likely that you have a self-hosted server and are using the default site. In this case, leave the content URL section blank. If you’re still having trouble finding your site information, consult the Tableau documentation or reach out to your Tableau Server Administrator who can find help here.
How do I setup a Tableau Metric?
Add a Tableau Key Result
- Hover over your Objective and click the Kebab.
- Select Edit Settings.
- Select Add another Key Result.
- Select Advanced Options.
- Choose Pull data from external applications.
- Pick Tableau from the list of integrations.
- Sign in to Tableau.
*For users whose organizations leverage SSO, you can login using a Tableau Personal Access Token. Learn more about Personal Access Tokens.
Note: WorkBoard does not enable the use of personal access tokens for user impersonation. WorkBoard only uses personal access tokens on behalf of the individual user to read data. - Select either a Workbook or Metric as an entry point. If you select a metric, click Save after the results are verified. If you select a Workbook, continue to step 9.
- Choose a Sheet from the dropdown.
Note: The Sheet dropdown will not show hidden sheets. - Choose a Calculation Type from the dropdown.
- Choose a Metric from the dropdown.
- (Optional) Choose a Filter and associated Filter Values as needed. You can select multiple Filters and multiple Filter Values can be selected per Filter.
- The Verify Data Source button pulls data from the selected Tableau dataset and feed in real-time; this allows you to cross reference with the data in Tableau to make sure you've mapped the right data field to the KR.
- Click Save.
- Fill out the remaining Key Result details such as Starting Value, Result Value, Target Value, Committed Result, Unit of Measurement and how toCalculate Overall Progress.
- Choose your Update Cadence, which determines when or how often WorkBoard will sync with Tableau to pull the latest value for your Key Result.
Note: Update cadence has the same options you would find for Key Results updated by a person (i.e., Daily, Weekly, Monthly, and Quarterly). - Select Save.
Synchronizing Data from Tableau
WorkBoard will pull data for the KR directly from Tableau following the cadence specified. The Business Result Owner also has the ability to “sync data now” to pull data in real-time.
There are two ways to sync data for your Key Results.
Force a Sync on a Single Tableau Key Result:
- Select Key Result to go to the Key Results Details page.
- Choose the Kebab menu in the upper right-hand corner.
- Select Sync Integration Data.
Forcing a Sync for all Key Result integrations:
- From the My Objectives Page, select the Kebab icon in the upper right-hand corner.
- Select Sync Integration Data.
To set up a Metric in Tableau you need an Explorer or Creator license, but don't need to be the original author of the dashboard. To do so, select Watch > Metrics > select a mark from the dashboard > and create the metric of their choice. Once created simply go to WorkBoard’s Tableau integration, under “Select an entry point” choose Metric and search for your newly created metric.