https://github.com/keshiarose/json-xml-wdc
A Tableau Web Data Connector for connecting to XML and JSON data.
https://github.com/keshiarose/json-xml-wdc
json tableau tableau-desktop wdc web-data-connector xml
Last synced: 21 days ago
JSON representation
A Tableau Web Data Connector for connecting to XML and JSON data.
- Host: GitHub
- URL: https://github.com/keshiarose/json-xml-wdc
- Owner: KeshiaRose
- License: mit
- Created: 2020-08-07T15:27:46.000Z (over 5 years ago)
- Default Branch: master
- Last Pushed: 2023-10-03T22:42:47.000Z (over 2 years ago)
- Last Synced: 2023-10-04T12:51:49.895Z (over 2 years ago)
- Topics: json, tableau, tableau-desktop, wdc, web-data-connector, xml
- Language: JavaScript
- Homepage: https://json-xml-wdc.herokuapp.com/
- Size: 98.6 KB
- Stars: 28
- Watchers: 5
- Forks: 18
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Simple JSON/XML Web Data Connector
Built by [Keshia Rose](https://twitter.com/KroseKeshia)
This is a simple [Web Data Connector](https://tableau.github.io/webdataconnector/docs/) for JSON and XML files, text, and URLs.
URL: `https://json-xml-wdc.herokuapp.com/`
Simply paste in your URL or data or just drag and drop a file.
Next, choose which fields to bring in to Tableau. You can select or clear all or individual fields, or select the parent of a nested object to change the selection of all within in.
You can also add multiple tables if your data has different levels of granularity.
This WDC only allows pulling in data from one source. If you need to pull data from multiple sources it may be best to use the WDC multiple times or to create a [custom WDC](https://tableau.github.io/webdataconnector/docs/).
## Why did I build this?
I've noticed that there are a lot of people asking in our [community forums](https://community.tableau.com/) how to connect to very simple data endpoints. Mostly public data that might be refreshed every so often. The answer we usually give is to build your own WDC. While for some that may be a simple task, I felt like it shouldn't be necessary to connect to a single source of data for quick analysis. When we first launched Web Data Connectors we had a sample that allowed you to connect to JSON endpoints. We removed and stopped updating this sample once we included the ability to connect to JSON files natively in the product. But we are still missing the ability to connect to simple URLs and XML. That's why I built this WDC, hopefully, it can help people who want to analyze a simple endpoint (or file, or just some stuff they copied) to do so without a heavy lift.
## Limitations
- Complex or super-nested data structures may fail
- Only pulls data from one URL endpoint, no pagination
- Data brought in from a file will not refresh, but URLs will
- No incremental extract refreshes
## How to deploy your own
I suggest deploying your own version of this WDC so you can have a dedicated application for your own use. Here are a few options for spinning up your own:
1. [Deploy it on Heroku](https://heroku.com/deploy?template=https://github.com/KeshiaRose/json-xml-wdc)
1. [Remix it on glitch](https://glitch.com/edit/#!/remix/json-xml-wdc)
Or you could host it locally by doing the following:
1. Install [Node.js](https://nodejs.org).
1. [Clone](https://github.com/KeshiaRose/JSON-XML-WDC) or download and unzip this repository.
1. Open the command line within the `JSON-XML-WDC` master folder and run `npm install` to install the node modules.
1. Then run `npm start` to start the web server or use something like [pm2](https://pm2.keymetrics.io/) for a production environment.
## How to refresh
##### Tableau Server
If you want to use this WDC on your Tableau Server you will first need to [add it to your safelist](https://help.tableau.com/current/server/en-us/datasource_wdc.htm) with the following commands:
```
tsm data-access web-data-connectors add --name "JSON XML WDC" --url https://json-xml-wdc.herokuapp.com:443
tsm pending-changes apply
```
Note that this will require your Tableau Server to restart!
##### Tableau Online
If you want to use this WDC on Tableau Online you will need to set it up using [Tableau Bridge](https://help.tableau.com/current/online/en-us/qs_refresh_local_data.htm)
## Questions?
[Open an issue!](https://github.com/KeshiaRose/JSON-XML-WDC/issues/new)
#### Support
I gladly host this WDC for free but if you would like to chip in for hosting you can [buy me some cheese🧀](https://www.buymeacoffee.com/KeshiaRose)!