|
| 1 | +# Kepler.gl Tableau |
| 2 | + |
| 3 | +## Introduction |
| 4 | +This is the kepler.gl tableau extension. It will load a kepler.gl map visualization inside your Tableau Desktop App. |
| 5 | + |
| 6 | +## Links |
| 7 | +- [kepler.gl](http://kepler.gl) |
| 8 | +- [Tableau Extensions API](https://tableau.github.io/extensions-api/#) |
| 9 | + |
1 | 10 | This project was bootstrapped with [Create React App](https://github.com/facebookincubator/create-react-app).
|
2 | 11 |
|
3 |
| -To run this project... |
4 |
| -- Clone repo |
5 |
| -- yarn |
6 |
| -- yarn run start |
7 |
| -- don't forget the trex file and tableau workbook (in the public folder) |
8 |
| - |
9 |
| -To execute extension in tableau |
10 |
| -- follow above steps to run extension locally on your machine. |
11 |
| -- open tableau workbook (get it from public folder of this repo) |
12 |
| - - NOTE: if you want to enable remote debugging, use this command in terminal to open tableau |
13 |
| - *open /Applications/Tableau\ Desktop\ 2018\.2.app --args --remote-debugging-port=8696* |
14 |
| - |
15 |
| -- copy the trex file (get it from public folder) into your "extensions" folder of the my tableau repository (likely in your documents folder). |
16 |
| -- Go to the Tableau window that opened when running the above command. |
17 |
| -- Drag the extension onto view and select the trex file from your my tableau repository\extensions folder. |
| 12 | +## Local Development |
| 13 | + |
| 14 | +### Start node app |
| 15 | +##### 1. Clone repo |
| 16 | +```sh |
| 17 | +git clone <> |
| 18 | +``` |
| 19 | + |
| 20 | +##### 2. Install |
| 21 | +```sh |
| 22 | +yarn --ignore-engines |
| 23 | +``` |
| 24 | + |
| 25 | +##### 3. Start local app session |
| 26 | +```sh |
| 27 | +yarn run start |
| 28 | +``` |
| 29 | + |
| 30 | +### Setup local extension in Tableau Desktop |
| 31 | +##### 1. Launch Tableau |
| 32 | +open tableau workbook (get it from public folder of this repo) |
| 33 | +- NOTE: if you want to enable remote debugging, use this command in terminal to open tableau |
| 34 | + |
| 35 | +```sh |
| 36 | +open /Applications/Tableau\ Desktop\ 2018\.3.app --args --remote-debugging-port=8696 |
| 37 | +``` |
| 38 | + |
| 39 | +A debug session will be available in browser http://localhost:8696 |
| 40 | + |
| 41 | +##### 2. Execute extension in tableau |
| 42 | + |
| 43 | +- copy the `datablick-kepler-gl.trex` file (inside the `public` folder) into your `extensions` folder of the `My Tableau Repository` (likely in your `Documents` folder). |
| 44 | + |
| 45 | +- Go to the Tableau window that opened when running the above command. |
| 46 | + |
| 47 | +- Drag the extension onto view and select the trex file from your my tableau repository\extensions folder. |
| 48 | + |
| 49 | +- More information on Tableau Extension API about [Get Started with Dashboard Extensions |
| 50 | +](https://tableau.github.io/extensions-api/docs/trex_getstarted.html) |
| 51 | + |
| 52 | + |
0 commit comments