Narratives for Tableau Add In

Setup

1. Install dependencies and build resources.

gulp install --app tableauAddIn
gulp build --app tableauAddIn

1. Copy the NarrativesForTableau.trex file from ./Extensions to ~/Documents/My Tableau Repository (Beta)/Extensions on your Windows machine so it is available to Tableau.
2. Run the following command in the windows command prompt: notepad c:\windows\system32\drivers\etc\hosts and add the line 10.0.2.2 tableau-add-in-landing-page.viz.dev to the bottom of the file.
3. Modify the landing-page/src/index.coffee file to make the landing page use regular http in local dev, since insecure SSL (i.e., serving from localhost) breaks the Tableau web driver: if config.ssl -> if false
   • Make sure not to stage these changes.
4. Run npm run servers from ns_products/viz.
5. Open a dashboard in the Tableau desktop application and drag the Narratives for Tableau extension onto the dashboard.

Differences between this and the Tableau chrome extension.

• The Add-in API is available as global variable named tableau. It no longer requires a pointer to the part of the HTML document which contains the viz to initialize. See the full API reference.
• Something about the drag and drop HTML5 backend library breaks the column selection modal in the version of Chromium that Tableau uses as a driver, so the add-in uses the Yahoo drag and drop library, which is intended for mobile use but supports basic mouse events (all we need).
• The Add-in API is used directly in main.js and reducers/worksheets.js. actions.js was also modified to no longer call worksheet.getDataSourcesAsync(), as it is not supported by the first version of the Add-in API.