You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: README.md
+6-7Lines changed: 6 additions & 7 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,4 +1,4 @@
1
-
# Annotate All The (Tableau)Things!
1
+
# Let's Annotate!
2
2
### Layering React Annotation on top of Tableau
3
3
4
4
## Introduction
@@ -7,10 +7,9 @@
7
7
8
8
This is the tableau extension that allows you to layer [Susie Lu's](https://twitter.com/datatoviz?lang=en)[react-annotation](https://react-annotation.susielu.com/) library on top of Tableau. When you add this to your dashboard (you will likely want to cover your entire dashboard with it) you can leverage the majority of annotation types and options available in [react-annotation](https://react-annotation.susielu.com/) directly within Tableau. We have built a simple configuration UI that you can take advantage of to be able annotate your viz to your heart's delight.
9
9
10
-
This extension is supported on **Tableau Desktop >=2018.2** and **Tableau Server**. It works best when deployed directly on to the Tableau Server you are using and the content of the extensions is also viewable on **Tableau Mobile**.
11
-
12
10
## Env Requirements
13
-
Tableau Desktop >= 2018.2 and Tableau Server >= 2018.2
11
+
version 1: Tableau Desktop >= 2018.2 and Tableau Server >= 2018.2, extension api v1.1+
12
+
version 1.1: Tableau Desktop & Server >= 2021.4, extension api v1.7+
14
13
15
14
This project was bootstrapped with [Create React App](https://github.com/facebook/create-react-app) along with [StarSchema](https://starschema.com/) & [DataBlick's](https://www.datablick.com/)**Tableau Extension Framework**.
16
15
@@ -25,7 +24,7 @@ Note: If you want the best experience, you should deploy a compiled version of t
25
24
26
25
#### Step 3a: Cover your Dashboard with the Extension Object. The best experience for now is to work with the extension using web edit on Tableau Server. Tableau Desktop is lacking transparency for Extension Objects. You are not required to cover your dashboard, but I found this the easiest way to use React Annotation across your viz.
27
26
28
-
#### Step 3b: Click the `Let's Annotate Things!` button.
#### Step 7: Once you have added all of your annotations you can hide the ability to modify the annotations from the end user by toggling these two configurations in the add/edit annotation config (these settings are global even though they are accessed in the add/edit annotation config).
49
+
#### Step 7: Once you have added all of your annotations you can hide the ability to modify the annotations from the end user by toggling these two configurations in the add/edit annotation config. These settings are global and are accessed through the settings icon on the top left of the extension space.
51
50
52
51

53
52
54
53
* Show Controls - When no is selected the end user will not be able to toggle add/edit mode on as the icons on the top left will be hidden. This will also default to turning off add/edit mode.
55
54
56
-
* Click Through Mode - Use this only when the extension is deployed directly onto your Tableau Server. It allows you to enable the end user to click through the extension layer and still interact with the Tableau Dashboard behind it.
55
+
* Click Through Mode - As of extension api v1.7+ this leverages the [setClickThroughAsync](https://tableau.github.io/extensions-api/docs/interfaces/extensions.html#setclickthroughasync) api. It allows you to enable the end user to click through the extension layer and still interact with the Tableau Dashboard behind it.
57
56
58
57
#### Step 8: If you want your changes to be retained, you **MUST** save your workbook before you close/exit Tableau. This will write the extension changes to your twb/twbx file.
0 commit comments