Skip to content

Commit

Permalink
getting started section
Browse files Browse the repository at this point in the history
  • Loading branch information
stephenlprice committed Jul 5, 2024
1 parent 0135ae5 commit 8d8d1af
Show file tree
Hide file tree
Showing 33 changed files with 147 additions and 72 deletions.
16 changes: 11 additions & 5 deletions pages/start/_meta.json
Original file line number Diff line number Diff line change
Expand Up @@ -2,13 +2,19 @@
"index": {
"title": "Getting Started"
},
"tableau": {
"title": "Tableau Platform"
"why": {
"title": "Why Tableau?"
},
"architecture": {
"title": "Architecture"
"what": {
"title": "What Is Tableau?"
},
"how": {
"title": "How Does It Work?"
},
"datadev": {
"title": "Who Is This For?"
},
"next": {
"title": "Next Steps"
}
}
}
8 changes: 0 additions & 8 deletions pages/start/architecture/_meta.json

This file was deleted.

Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
import { Callout } from 'nextra/components'

# Tableau Community
# Tableau for Developers

<Callout type="warning" emoji="⚠️">
This website is under construction. Content on this page is a placeholder.
Expand Down
36 changes: 36 additions & 0 deletions pages/start/how.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,36 @@
## How do I Embed Tableau?

Embedding Tableau content allows you to add the power of interactive visualization to external applications. Common use cases of embedding are:

* Tableau dashboards as components of line-of-business or vertical applications
* Embedding into internal knowledge bases and CRM systems
* Adding interactive visualizations to blog posts
* Embedding into [custom mobile applications](https://github.com/tableau/embedding-playbook/blob/master/pages/05_embedding_in_other_apps.md#embedding-into-mobile-apps)

The act of embedding a single dashboard or visualization into a single webpage is quite simple, but a well-engineered integration requires handling other things such as authentication, authorization, content management, and performance. Depending on your integration goals, you may require the use of a variety of features and techniques.

The following list provides a summary of the key APIs and features that are used in embedded deployments. The rest of the playbook will then dive into the key embedding requirements, explain how to accomplish those requirements, and supply you with resources necessary to get up and running.

## Key features and APIs

**[Embedding API v3](https://help.tableau.com/current/api/embedding_api/en-us/index.html)** - The Embedding API v3 provides an updated developer experience and enhancements over the JavaScript API v2. The Embedding API v3 provides [web components](https://developer.mozilla.org/en-US/docs/Web/Web_Components) for embedding Tableau visualizations and is available starting with Tableau version 2021.4.

**[REST API](https://help.tableau.com/current/api/rest_api/en-us/REST/rest_api.htm)** - Allows for integration between an embedding application and Tableau Server or Tableau Online by way of RESTful endpoints that manage users, content, and permissions amongst many other capabilities provided by the Tableau platform. Common use-cases include integrating user management in Tableau with user management in the embedding application, managing content and permissions according to the state of the embedding application, querying Tableau metadata so the correct information is displayed to end-users, and automating the management of Tableau Server.

**[Connected Apps](https://help.tableau.com/current/online/en-us/connected_apps.htm)** - Enables a seamless and secure authentication experience by facilitating an explicit trust relationship between Tableau Online or Tableau Server and external applications where Tableau content is embedded. The trust relationship is established and verified through an authentication token in the [JSON Web Token (JWT) standard](https://datatracker.ietf.org/doc/html/rfc7519), which uses a shared secret provided by the Tableau connected app and signed by your external application.

***NOTE:** Connected Apps is available for both Tableau Server and Tableau Online using the [Embedding API v3](https://help.tableau.com/current/api/embedding_api/en-us/index.html).*

**[External Authorization Servers (EAS)](https://help.tableau.com/current/server/en-us/connected_apps_eas.htm)** - Establishes a trust relationship between Tableau Server and the EAS. By establishing a trust relationship, you’re able to provide your users a single sign-on (SSO) experience to Tableau content embedded in your external applications through the identity provider (IdP) you’ve already configured for Tableau Server. When embedded Tableau content is loaded in your custom application, a standard OAuth flow is used. After users successfully sign in to the IdP, they are then automatically signed in to Tableau Server. To register an EAS with Tableau Server, you must have an EAS already configured. In addition, the EAS must send a valid [JSON web token (JWT)](https://datatracker.ietf.org/doc/html/rfc7519).

***NOTE:** EAS is only available for Tableau Server and the [Embedding API v3](https://help.tableau.com/current/api/embedding_api/en-us/index.html).*

**[SAML, OpenID, Active Directory, Kerberos](https://help.tableau.com/current/server/en-us/security_auth.htm)** - For environments that already use one of these systems, they can be leveraged to achieve Single Sign-On (and to leverage database security in the case of Kerberos).

**[Tableau Viz Lightning web component](https://www.tableau.com/products/viz-lightning-web-component-salesforce)** - Makes it easy to [Embed Tableau views into Salesforce Lightning pages](https://help.tableau.com/current/pro/desktop/en-us/embed_ex_lwc.htm). The Tableau Viz Lightning web component is available from the Salesforce AppExchange. To embed a view, you simply drag and drop the Tableau Viz Lightning web component onto the page and then provide the URL for the Tableau view. You can embed Tableau views from Tableau Server, Tableau Online, or Tableau Public.

**Mobile App Bootstrap** - Samples/Templates for embedding in mobile apps. A great way to get up and running if you have mobile apps and want to include Tableau content or if you want a customized mobile experience for Tableau.

**[Document API](http://tableau.github.io/document-api-python/)** - API for updating data source connection information. Allows you to build content once (i.e. templates) in the scenario that you have many, structurally similar, databases for multi-tenancy or dev/test/prod scenarios.

**User Filtering** - Functionality for securely filtering a workbook based on the Tableau Server or Online login information. In multi-tenant scenarios, if you have a single database for multiple users or clients, you can use user filters to have the same content apply to the different clients, ensuring each user can only see the rows that he or she has access to.
57 changes: 17 additions & 40 deletions pages/start/index.mdx
Original file line number Diff line number Diff line change
@@ -1,9 +1,7 @@
import { Callout } from 'nextra/components';

# Getting Started

Are your digital experiences <span className='text-orange-600 font-bold italic'>missing something important</span>? Something that can give them that edge
back and make them look modern and engaging?
Are your digital experiences <span className='text-orange-600 font-bold italic'>missing something important</span>? Something that can give them the edge and
make them look modern and engaging.

Are your customers demanding access to <span className='text-emerald-600 font-bold italic'>more data, better analytics and AI</span> yet your apps struggle to
keep up with the pace of change?
Expand All @@ -16,44 +14,23 @@ that leverage the most exciting capabilities in the world of <span className='te

![product highlights](/img/tableau/stock/showcase.png)

## What is Embedded Analytics?

## Why Embed Tableau?

## How do I Embed Tableau?


Embedding Tableau content allows you to add the power of interactive visualization to external applications. Common use cases of embedding are:

* Tableau dashboards as components of line-of-business or vertical applications
* Embedding into internal knowledge bases and CRM systems
* Adding interactive visualizations to blog posts
* Embedding into [custom mobile applications](https://github.com/tableau/embedding-playbook/blob/master/pages/05_embedding_in_other_apps.md#embedding-into-mobile-apps)

The act of embedding a single dashboard or visualization into a single webpage is quite simple, but a well-engineered integration requires handling other things such as authentication, authorization, content management, and performance. Depending on your integration goals, you may require the use of a variety of features and techniques.

The following list provides a summary of the key APIs and features that are used in embedded deployments. The rest of the playbook will then dive into the key embedding requirements, explain how to accomplish those requirements, and supply you with resources necessary to get up and running.

## Key features and APIs

**[Embedding API v3](https://help.tableau.com/current/api/embedding_api/en-us/index.html)** - The Embedding API v3 provides an updated developer experience and enhancements over the JavaScript API v2. The Embedding API v3 provides [web components](https://developer.mozilla.org/en-US/docs/Web/Web_Components) for embedding Tableau visualizations and is available starting with Tableau version 2021.4.

**[REST API](https://help.tableau.com/current/api/rest_api/en-us/REST/rest_api.htm)** - Allows for integration between an embedding application and Tableau Server or Tableau Online by way of RESTful endpoints that manage users, content, and permissions amongst many other capabilities provided by the Tableau platform. Common use-cases include integrating user management in Tableau with user management in the embedding application, managing content and permissions according to the state of the embedding application, querying Tableau metadata so the correct information is displayed to end-users, and automating the management of Tableau Server.

**[Connected Apps](https://help.tableau.com/current/online/en-us/connected_apps.htm)** - Enables a seamless and secure authentication experience by facilitating an explicit trust relationship between Tableau Online or Tableau Server and external applications where Tableau content is embedded. The trust relationship is established and verified through an authentication token in the [JSON Web Token (JWT) standard](https://datatracker.ietf.org/doc/html/rfc7519), which uses a shared secret provided by the Tableau connected app and signed by your external application.

***NOTE:** Connected Apps is available for both Tableau Server and Tableau Online using the [Embedding API v3](https://help.tableau.com/current/api/embedding_api/en-us/index.html).*

**[External Authorization Servers (EAS)](https://help.tableau.com/current/server/en-us/connected_apps_eas.htm)** - Establishes a trust relationship between Tableau Server and the EAS. By establishing a trust relationship, you’re able to provide your users a single sign-on (SSO) experience to Tableau content embedded in your external applications through the identity provider (IdP) you’ve already configured for Tableau Server. When embedded Tableau content is loaded in your custom application, a standard OAuth flow is used. After users successfully sign in to the IdP, they are then automatically signed in to Tableau Server. To register an EAS with Tableau Server, you must have an EAS already configured. In addition, the EAS must send a valid [JSON web token (JWT)](https://datatracker.ietf.org/doc/html/rfc7519).

***NOTE:** EAS is only available for Tableau Server and the [Embedding API v3](https://help.tableau.com/current/api/embedding_api/en-us/index.html).*
## Can Tableau help me build apps with analytics and AI?

**[SAML, OpenID, Active Directory, Kerberos](https://help.tableau.com/current/server/en-us/security_auth.htm)** - For environments that already use one of these systems, they can be leveraged to achieve Single Sign-On (and to leverage database security in the case of Kerberos).
[Tableau](https://www.tableau.com/products/tableau) provides a platform to securely share engaging [data visualizations](https://www.tableau.com/products/desktop),
dashboards and reports. You also have access to cutting edge AI-driven analysis via [Tableau Pulse](https://www.tableau.com/products/tableau-pulse)
and assistance from [Tableau Einstein](https://www.tableau.com/blog/einstein-copilot-tableau-data-analysis-with-ai)
throughout your workflow.

**[Tableau Viz Lightning web component](https://www.tableau.com/products/viz-lightning-web-component-salesforce)** - Makes it easy to [Embed Tableau views into Salesforce Lightning pages](https://help.tableau.com/current/pro/desktop/en-us/embed_ex_lwc.htm). The Tableau Viz Lightning web component is available from the Salesforce AppExchange. To embed a view, you simply drag and drop the Tableau Viz Lightning web component onto the page and then provide the URL for the Tableau view. You can embed Tableau views from Tableau Server, Tableau Online, or Tableau Public.
![tableau desktop](/img/tableau/stock/tableau_ai.png)

**Mobile App Bootstrap** - Samples/Templates for embedding in mobile apps. A great way to get up and running if you have mobile apps and want to include Tableau content or if you want a customized mobile experience for Tableau.
Finding value from complex data sources throughout your organization requires [reliable and accessible tools](https://www.tableau.com/products/desktop)
that consistently provide results across teams and business units. This foundational platform unlocking deeper analysis within
companies is the same infrastructure that helps [Tableau customers](https://www.tableau.com/solutions) leverage data and analytics
for a variety of usecases and custom applications with consistent success.

**[Document API](http://tableau.github.io/document-api-python/)** - API for updating data source connection information. Allows you to build content once (i.e. templates) in the scenario that you have many, structurally similar, databases for multi-tenancy or dev/test/prod scenarios.
![tableau desktop](/img/tableau/stock/desktop_hero.png)

**User Filtering** - Functionality for securely filtering a workbook based on the Tableau Server or Online login information. In multi-tenant scenarios, if you have a single database for multiple users or clients, you can use user filters to have the same content apply to the different clients, ensuring each user can only see the rows that he or she has access to.
To succeed in delivering these sophisticated experiences to your end users the most
<span className='text-orange-600 font-bold italic'>important ingredient is people</span>.
Your people and their success with an analytics platform and the [Tableau community](https://www.tableau.com/community),
who is there to help you grow.
5 changes: 0 additions & 5 deletions pages/start/tableau/_meta.json

This file was deleted.

7 changes: 0 additions & 7 deletions pages/start/tableau/products.mdx

This file was deleted.

17 changes: 17 additions & 0 deletions pages/start/what/_meta.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,17 @@
{
"index": {
"title": "Tableau Platform"
},
"hosting": {
"title": "Hosting Environments"
},
"visual": {
"title": "Visual Analytics"
},
"ai": {
"title": "Artificial Intelligence"
},
"wrangling": {
"title": "Data Wrangling"
}
}
11 changes: 11 additions & 0 deletions pages/start/what/ai.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,11 @@
import { Callout } from 'nextra/components';

# Artificial Intelligence

## Tableau Pulse

## Tableau Einstein Copilot

<Callout type="warning" emoji="⚠️">
This website is under construction. Content on this page is a placeholder.
</Callout>
Original file line number Diff line number Diff line change
@@ -1,6 +1,10 @@
import { Callout } from 'nextra/components'
import { Callout } from 'nextra/components';

# Tableau Developers #datadev
# Hosting Environments

## Tableau Cloud

## Tableau Server

<Callout type="warning" emoji="⚠️">
This website is under construction. Content on this page is a placeholder.
Expand Down
18 changes: 18 additions & 0 deletions pages/start/what/index.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,18 @@
# Tableau Products

Tableau is a platform, a community and an ecosystem. The technology that drives it allows people to see and understand data
within a secure and scalable environment.

![Tableau Products](/img/tableau/tableau_products.png)

Analyzing data requires tooling that can connect to pretty much any data source and is useful for visualization,
working with [statistical models](https://help.tableau.com/current/pro/desktop/en-us/explain_data_explanation_types.htm)
as well as data wrangling or ETL. All of which is aided by artificial intelligence.

Succesful analysis needs to be communicated to others in order to have an impact. This is an an additional strength of Tableau,
as its powerfully creative products allow individuals to share insights safely in a secure environment.

![Tableau Platform](/img/tableau/tableau_platform.png)

The Tableau platform has multiple layers. This site will help you get started understanding how to use these capabilities
to build analytical apps. Here is a quick introduction to the products the make up [Tableau](https://www.tableau.com/products/tableau).
Original file line number Diff line number Diff line change
@@ -1,6 +1,10 @@
import { Callout } from 'nextra/components'
import { Callout } from 'nextra/components';

# Tableau Server
# Visual Analytics

## Tableau Desktop

## Web Authoring

<Callout type="warning" emoji="⚠️">
This website is under construction. Content on this page is a placeholder.
Expand Down
Original file line number Diff line number Diff line change
@@ -1,6 +1,8 @@
import { Callout } from 'nextra/components'
import { Callout } from 'nextra/components';

# Tableau Cloud
# Data Wrangling

## Tableau Prep Builder

<Callout type="warning" emoji="⚠️">
This website is under construction. Content on this page is a placeholder.
Expand Down
20 changes: 20 additions & 0 deletions pages/start/why.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,20 @@
# Why Tableau?

We could start this article describing all of the amazing features our users have come to love but nothing is a better testament to
Tableau's value than our [vibrant community](https://www.tableau.com/community) of analysts, business people and data enthusiasts.
We welcome people from all over the world into an [active ecosystem](https://www.tableau.com/why-tableau/tableau-economy)
of creators and explorers.

Achieving these amazing results would be impossible without a trusted platform that unlocked the creativity and energy of thousands
of individuals across all industries. The best place to explore what the community looks like would be to visit [Tableau Public](https://public.tableau.com/app/discover)
and marvel at the data-driven content posted by members of the community every single day.
<span className='text-orange-600 font-bold italic'>That's success you can count on</span>!

![tableau community](/img/tableau/stock/tableau_visionary.png)

What this means to people concerned with projects and results is that Tableau is the best place to source talent and expertise and
it provides the best conditions to grow a [data culture](https://www.tableau.com/why-tableau/data-culture) of your own. Ultimately,
to have consistent success with endeavors involving data and analytics it is important to nurture your own capabilities around
platforms proven to succeed at scale.

We welcome you with open arms to explore how much <span className='text-indigo-600 font-bold italic'>fun you can have with your data</span>!
Binary file added public/img/tableau/data_dev.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added public/img/tableau/exchange_logo.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added public/img/tableau/stock/dashboard.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added public/img/tableau/stock/data_culture.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added public/img/tableau/stock/datafam.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added public/img/tableau/stock/desktop_hero.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added public/img/tableau/stock/desktop_scatter.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added public/img/tableau/stock/explain_data.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added public/img/tableau/stock/insights.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added public/img/tableau/stock/permissions.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added public/img/tableau/stock/prep.gif
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added public/img/tableau/stock/prep.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added public/img/tableau/stock/prep_builder.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added public/img/tableau/stock/slack.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added public/img/tableau/stock/tableau+.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added public/img/tableau/stock/tableau_ai.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added public/img/tableau/stock/tableau_visionary.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added public/img/tableau/stock/videos.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added public/img/tableau/tableau_products.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.

0 comments on commit 8d8d1af

Please sign in to comment.