Get Started

Important: Tableau Web Data Connector 2.0 (this version) is being deprecated at Tableau 2023.1 and eventually retired. We will still support WDC 2.0 until its last compatible version of Tableau (Tableau 2022.4) goes End of Life and is no longer supported.

For information about Tableau Web Data Connector 3.0, see the WDC 3.0 documentation.


Create a Web Data Connector (WDC) when you want to connect to a web data source from Tableau. A WDC is an HTML page with JavaScript code that connects to web data (for example, by means of a REST API), converts the data to a JSON format, and passes the data to Tableau.

Note: This site is for version 2.x of the WDC API, which is compatible only with Tableau 10.0 and later. Version 1 of the WDC API, used with earlier versions of Tableau, is no longer supported.

Upgrading from WDC version 1.x

If you have connectors that were created using WDC version 1.x, those connectors might not work in later versions of Tableau. If you want your connector to work in later versions of Tableau, or if you want to use the features available in version 2.x of the WDC, you will need to update the connector. For information about updating your connectors, see Upgrading from WDC Version 1.x. For information about version compatibility, see WDC Versions.


This section will guide you through the process of setting up your development environment and running the sample WDCs in the simulator.

Confirm prerequisites

You’re going to need a couple of things before we get started. Make sure you have the following dependencies installed:

Get the WDC SDK

  1. Open a terminal in the directory where you want to download the WDC SDK. Then run the following command to clone the WDC git repository:

    git clone https://github.com/tableau/webdataconnector.git
    
  2. Change to the directory where you downloaded the repository:

    cd webdataconnector
    

Run the simulator

  1. Install dependencies with npm:

    npm install --production
    

    Note: You must run the command with administrator or sudo privileges.

  2. Start the test web server:

    npm start
    
  3. Open a browser and navigate to the following URL:

    http://localhost:8888/Simulator/index.html
    

    The WDC simulator appears.

Note: The npm start command also starts a test proxy server on port 8889 that you can route requests through in order to circumvent Cross Origin Resource Sharing (CORS) restrictions. For more information, see Working with CORS.

Try the sample WDCs

  1. In the WDC URL field, confirm that the URL is set to the sample USGS Earthquake Data connector:

    ../Examples/html/earthquakeUSGS.html
    

    Alternatively, look in the Examples directory for more sample connectors.

  2. Click the Start Interactive Phase button to display the user interface for the earthquake WDC.

  3. Click the Get Earthquake Data button.

  4. Click the Fetch Table Data button to download the data and display it in a table.

Ready to make your own connector? Jump to the WDC Tutorial.