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.
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.
You’re going to need a couple of things before we get started. Make sure you have the following dependencies installed:
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
Change to the directory where you downloaded the repository:
Install dependencies with
npm install --production
Note: You must run the command with administrator or sudo privileges.
Start the test web server:
Open a browser and navigate to the following URL:
The WDC simulator appears.
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.
In the WDC URL field, confirm that the URL is set to the sample USGS Earthquake Data connector:
Alternatively, look in the Examples directory for more sample connectors.
Click the Start Interactive Phase button to display the user interface for the earthquake WDC.
Click the Get Earthquake Data button.
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.