Skip to main content
All CollectionsTableau Connector
How do I connect Tableau to Funnel? (Tableau Connector v2)
How do I connect Tableau to Funnel? (Tableau Connector v2)

Setup and migration guide for our new Tableau Connector v2

Funnel Support avatar
Written by Funnel Support
Updated over 2 months ago

About the Connector

We have built a new Tableau connector using Tableau’s Web Data Connector 3.0. This Tableau Connector v2 will eventually replace our existing Tableau connector v1 when Tableau stops supporting WDC 2.0.

Our Tableau Connector v1 will be deprecated and removed from Tableau at the end of 2025.

Note: This connector does NOT work with Tableau Cloud/Online

Migration Steps

2. Install the Connector for Tableau Desktop

  1. Move the downloaded funnel .taco file into the folder below (if the folder does not exist, create it):

    1. Windows: C:\Program Files\Tableau\Connectors

    2. macOS: Documents/My Tableau Repository/Connectors

  2. Delete any older versions of the connector from the "Connectors" folder

  3. Restart Tableau Desktop

  4. You should now be able to find the connector Funnel by Funnel under "Connect to a Server" in Tableau Desktop

3. Install the Connector for Tableau Server

The following steps need to be done by the Tableau Server Administrator.

  1. Move the downloaded funnel .taco file into the folder below (if the folder does not exist, create it):

    1. Windows: C:\Program Files\Tableau\Connectors

    2. Linux: /opt/tableau/connectors

  2. Contact Funnel support and give us the following information:

    1. Your Tableau Server URL

  3. Funnel will create the following information that you will need when running the tsm commands below:

    1. client_id

    2. client_secret

  4. Run the commands:

    1. > tsm configuration set -k oauth.config.clients -v "[{\"oauth.config.id\":\"funnel\", \"oauth.config.client_id\":\"<client_id>\", \"oauth.config.client_secret\":\"<client_secret>\", \"oauth.config.redirect_uri\":\"<tableau_server_url>/auth/add_oauth_token\"}]" --force-keys


      > tsm pending-changes apply
  5. Login to Tableau Server UI and Click "My Account Settings" and go to the section called "Saved Credentials for Data Sources". Find the connector called "Funnel by Funnel" and press "Add". Sign in with your credentials.

  6. Open Tableau Desktop and when publishing a new Workbook. Under Data Source press "Edit" and set "Publish Type" to "Embedded in Workbook" and "Authentication" to "Embed <your_user_name>".

4. Replace Data Source in a Workbook

  1. Open the workbook

  2. Select Data > New Data Source and connect using the Tableau Connector v2 (called “Funnel by Funnel” in Tableau)

  3. Go to the sheet tab and select Data > Replace Data Source

  4. Done!

Tableau help article with more detailed information.

5. Replace Data Source in a Published Workbook

  1. Open the published workbook

  2. Follow the steps above for replacing the data source in the workbook

  3. Publish the workbook and overwrite the workbook that was already published

  4. Done!


FAQ

Does this connector version support Tableau Cloud / Online?

At the moment there is no support for connectors built with the Web Data Connector 3.0 SDK from Tableau.

How do I setup a scheduled refresh in Tableau Server?

  1. Follow the guide above to setup the connector in Tableau Server

    1. Note: during the publishing step there is a choice to set a schedule for extract refreshes and there is also a possibility to embed credentials for the data source.

  2. In the Tableau Server UI, find your report, try to run a refresh of the extract manually.

  3. Select the schedule, choose Actions and refresh now.

  4. If the refresh fails, find the data source and edit the connection, Add a Funnel by Funnel Account.

  5. Try the manual extract again. If the refresh was successful move on to the next point.

More information about Extract Refresh Schedules can be found in Tableau Help.

Additional resources

  • If you want to connect using Tableau Connector v1, follow the steps outlined in this article.

  • Tableau help article on how to setup a connector built on Web Data Connector 3.0 SDK.

  • Tableau help article with more detailed information on how to replace a Data Source in a Workbook.

Did this answer your question?