Updating releaes notes; adding support for Mermaid; update pause befo…

…re loading

_config.yml

@@ -23,7 +23,11 @@ github: [metadata]
 kramdown:
     toc_levels: 1..3
 
+gems: [jekyll-mermaid]
+mermaid: https://cdn.jsdelivr.net/npm/mermaid/dist/mermaid.min.js 
+
 # Exclude
-exclude: ['node_modules', 'Examples']
+exclude: ['node_modules', 'Examples', 'vendor']
+
 
 

_includes/head.html

@@ -14,5 +14,13 @@
   <script src="{{ site.baseurl }}/assets/js/redirect-to-search.js"></script>
   <script src="https://ajax.googleapis.com/ajax/libs/jquery/1.11.3/jquery.min.js"></script>
   <script src="https://maxcdn.bootstrapcdn.com/bootstrap/3.4.1/js/bootstrap.min.js"></script>
+  <script src="https://cdn.jsdelivr.net/npm/mermaid/dist/mermaid.min.js"></script>
+  <script>
+    mermaid.initialize({
+      startOnLoad:true,
+      sequence: { showSequenceNumbers: true }, 
+    });
+  </script>
+
 
 {% if jekyll.environment == "production" %}{% include analytics.html %}{% endif %}

docs/trex_debugging.md

@@ -100,7 +100,7 @@ This command enables remote debugging of extensions for this session of Tableau.
 
 ## Debugging Tableau Desktop using Chrome/Chromium
 
-After you install the Chromium browser and enable debugging in Tableau, you can start debugging your extension.
+After you install the Chrome (or Chromium) browser and enable debugging in Tableau, you can start debugging your extension.
 
 1. Open the dashboard with the extension you want to debug in Tableau. 
 2. Start Chromium and set the URL to [`http://localhost:8696`](http://localhost:8696)  
@@ -115,9 +115,24 @@ Note that you can only debug one extension, or instance of an extension, at a ti
 
 ---
 
-## Debugging loading and initialization issues
+## Debugging loading and initialization issues (Tableau 2021.1 and later)
 
-It can be difficult to hit breakpoints that occur during the loading of your page because of the remote debugging process. To help with this, you can select a menu option that causes your extension to wait to load until you trigger it to proceed.
+If you need to troubleshoot or debug issues that prevent your extension from loading or initializing, you can set breakpoints that trigger when your JavaScript code is loaded.
+
+1. Start the debugging session as described in [Debugging Tableau Desktop using Chrome/Chromium](#debugging-tableau-desktop-using-chromechromium).
+
+1. Click the **Sources** tab in Chrome/Chromium, under **Event Listener Breakpoints**, click **Script** and enable the **Script First Statement** breakpoint. You just have to do this one time.
+
+1. In Tableau Desktop, select the extension in the dashboard and click **Reload** from the **More Options** shortcut menu. <br/>
+The debugger will pause each time the first statement of a script runs, allowing you to debug the startup process.
+
+1. To get to your JavaScript code, click **Continue** several times. After your JavaScript is loaded, you can set a breakpoint in your startup code.
+
+---
+
+## Debugging loading and initialization issues (Tableau 2020.4 and earlier)
+
+It can be difficult to hit breakpoints that occur during the loading of your page because of the remote debugging process, and because of the way loading was handled prior to Tableau 2021.1. To help with this, you can select a menu option that causes your extension to wait to load until you trigger it to proceed.
 
 1. Select the extension in the dashboard and select **Debug Options** > **Pause Before Loading** from the shortcut menu.
 2. Reload your extension. Select **Reload** from the shortcut menu.

docs/trex_oauth.md

@@ -32,6 +32,30 @@ The following outlines some of the basic steps in using a secondary window for O
 
 * In response to the signal, the extension retrieves and stores the OAuth token in local storage on the client's computer. The extension can then use the access token to send subsequent requests for services from the OAuth provider.
 
+---
+<div class="mermaid">
+sequenceDiagram
+    participant User
+    participant E as Extension (client)
+    participant S as Server (web host)
+    participant O as OAuth provider
+    User->>E: Load dashboard extension
+    E->>S: Open communication channel
+    S-->>E: Use this socket session ID (socket.id)
+    E->>O: Request the OAuth login page (with client ID)
+    O-->>User: Prompt user: Allow or deny access?
+    User->>O: Allow!
+    O-->>S: Here's the auth code
+    S->>O: Auth code request + client ID, client secret, session ID
+    O-->>S: Here's the access token
+    Note right of E: Route the access token based on session ID
+    S->>E: This access token is for this session ID.
+    Note right of E: Use the access token to request data
+
+</div>
+
+
+
 ---
 
 ## An example of the OAuth code path using Socket.IO

docs/trex_release-notes.md

@@ -11,9 +11,44 @@ layout: docs
 ----
 See also: [Known Issues]({{site.baseurl}}/docs/trex_known_issues.html)
 
+----
+
+### Tableau Dashboard Extensions API version 1.5
+
+*June 2021*
+
+* Tableau Dashboard Extensions API library: `tableau.extensions.1.5.0.js` <br>(download or clone the Extensions API repository on [GitHub](https://github.com/tableau/extensions-api){:target="_blank"}.) <br/>
+
+About this release:
+
+* The `Filter.getFieldAsync` method now works as expected and properly returns the field. This fix requires Tableau 2019.2 and later.
+
+* Show/Hide (`setZoneVisibilityAsync`) can now be applied to any dashboard zone.
+
+* The `selectMarksByValueAsync` method now supports combined selection criteria types (bug fixed).
+
+* The following are all improvements to the `getSummaryData` method:
+
+  * `getSummaryData` now has a smaller and faster payload.
+
+  * `maxRows` can be applied to `getSummaryData` to restrict the number of rows fetched.
+
+  * `columnsToIncludeById` can be applied to `getSummaryData` to restrict the columns fetched.
+
+  * `includeDataValuesOnly` or `includeFormattedValuesOnly` can be applied to `getSummaryData` to restrict the amount of information returned to what you really need.
+
+  * The `getSummaryColumnsInfoAsync` method is a new in this release. It returns the column information for each column that will be returned in `getSummaryData`.
+
+* The column information now includes the `fieldId` as well as the field name.
+
+For more information about changes in this release, see [Tableau Extensions v1.5.0](https://github.com/tableau/extensions-api/releases/tag/v1.5.0){:target="_blank"}.
+
+
+
 ----
 
 ### Tableau 2021.1 Updates
+
 *March 2021*
 
 * You can now use Chrome version 80 and later to debug your dashboard extension in Tableau Desktop. If you are using Tableau 2021.1, or the latest maintenance releases of Tableau 2020.2, 2020.3, or 2020.4, you no longer need to use Chromium (version 79 or earlier) for debugging. For more information, see [Debug Extensions in Tableau Desktop]({{site.baseurl}}/docs/trex_debugging.html) and [Download the Chromium Browser]({{site.baseurl}}/docs/trex_debugging.html#download-the-chromium-browser).