Embedding into other apps
This website is under construction. Content on this page is a placeholder.
Much of this playbook focuses on embedding Tableau content in custom-developed web applications, but there are three common embedding scenarios that have specific requirements: SharePoint, Salesforce, and Mobile Apps.
Embedding in SharePoint
Tableau provides a SharePoint Web Part to facilitate SharePoint embedding scenarios.
The Web Part, as well as the instructions for installing it are located under C:\Program Files\Tableau\Tableau Server\<version>\extras\embedding\sharepoint within your Tableau Server install directory.
You can embed Tableau Online views into SharePoint as well, but neither Active Directory nor Trusted Tickets are supported for Online.
See also
- Documentation for embedding in SharePoint with Active Directory (opens in a new tab)
- Documentation for embedding in SharePoint with Local Authentication (opens in a new tab)
Embedding into Salesforce Lightning
Tableau provides a free Salesforce Lightning web component that facilitates embedding scenarios. The latest version of the Tableau Viz Lightning web component is available from the AppExchange (opens in a new tab)
The Tableau Viz Lightning web component makes it easy to Embed Tableau views into Salesforce Lightning pages (opens in a new tab). To install the Tableau Viz Lightning web component in your Salesforce org you just need to be a Salesforce Administrator. After it’s installed, you can just drag and drop the Tableau component on any Salesforce page and set the URL to any view on Tableau Server, Tableau Online, or Tableau Public.
The Tableau Viz Lightning web component lets you quickly filter views based on the Lightning page you embed them in. You can also select filters based upon Tableau and Salesforce fields.
Based on the Salesforce Lightning Web Component framework and the Tableau JavaScript API for embedding, developers can extend and customize the open-source Tableau Viz Lightning web component project on GitHub. For more information, see Tableau Viz Lightning Web Component (opens in a new tab) and the Tableau Viz LWC Samples (opens in a new tab).
The Tableau Viz Lightning web component does not support Salesforce Classic. For information about using the Salesforce Canvas adapter, see the following Knowledge Base article, Tableau Viz Lightning Web Component Does Not Work On Salesforce Classic (opens in a new tab).
For convenience, you can configure Tableau to use Single Sign-On (SSO) with Salesforce. The Tableau Viz Lightning web component only supports SAML as the SSO method. The SAML IdP used for Tableau authentication must be either the Salesforce IdP or the same IdP that is used for your Salesforce instance. Configuring Tableau Server or Tableau Online requires Tableau administrator permissions.
-
For information about setting up SSO with Tableau Online, see Configure SAML with Salesforce (opens in a new tab) and Configure SAML for Tableau Viz Lightning Web Component (opens in a new tab).
-
For information about setting up SSO with Tableau Server, see Configure SAML for Tableau Viz Lightning Web Component (opens in a new tab).
-
Learn more about the Tableau Viz Lightning web component by completing the Embed Tableau Visualizations in Salesforce (opens in a new tab) Trailhead project.
Embedding into Mobile Apps
Tableau Server and Online users can access their Tableau content via Tableau-released mobile applications, but it is often desirable to create custom mobile apps the embed Tableau content or to embed Tableau content into existing mobile apps. To aid in that scenario, Tableau has released an open-source sample called the Mobile App Bootstrap. The samples demonstrates how co connect and stay signed into a Tableau Server, embed Tableau content and interact with it using JavaScript API. They are good resources to use as a starting point for mobile application development or as samples to learn from.
The Mobile App Bootstrap comes in two flavors:
- Objective-C (opens in a new tab) -- If your app development is done in Objective-C and/or Swift, this template will help you embed Tableau content.
- HTML/CSS/JS/Cordova (opens in a new tab) -- Cordova (opens in a new tab) is an engine that allows you to develop cross-device mobile applications in HTML/CSS/JS. If you are not already an ObjC/Swift shop, the Cordova template for embedding in mobile applications is a good choice.
In addition, Tableau has released the Mobile Connected Client Plugin (opens in a new tab) which can accompany the Mobile App Bootstrap, or any app that embeds Tableau content, to handle authentication so that your users do not have to continually sign in to Tableau Server.