Send to Tableau Server

Sends the input data to a Tableau Server. The node uses the Tableau Hyper API to generate a hyper file and, secondly, send that hyper file as a datasource to the Tableau Server via the Tableau REST API.

Uses version 2.8 of the Tableau Server REST API. Therefore the minimum Tableau server version is 10.5.

Options

Settings

Host
The URL of the server to connect to. Including the protocol 'http://' or 'https://'.
Site Content URL
The string defining the Tableau site. Pass an empty string to connect to the default site.
Note that the name of the site is not always the site content URL. For the "Default" site the site content URL is an empty string "". For all other sites the site content URL can be extracted from the browser address bar when you are logged into the site. The value follows /site/ in the address bar.
Example: For the following URLs, the Site Content URL is MarketingTeam :
  • (Tableau Server) http://MyServer/#/site/MarketingTeam/home
  • (Tableau Online) https://10ay.online.tableau.com/#/site/MarketingTeam/workbooks
Timeout
Timeout for a single request in seconds.
Username and Password
Select this option to authenticate using your username and password. Note that this method cannot be used if MFA is enabled on your account. Use an personal access token instead.
  • Username: The username of the user to sign in as. The user must have permissions to publish to the specified site.
  • Password The password of the user to sign in as.
  • Use credentials Use a credentials variable to supply the username and password instead.
Personal Access Token
Select this option to authenticate using a Personal access token. This method of authentication can be used with Tableau Server 2019.4 and higher. Advantages are improved security (personal access tokens can be revoked at any time) and auditing and tracking (administrators can track in the Tableau Server log when a token is used). See Tableau Documentation - Personal Access Tokens for additional information.
Personal Access tokens can be created on the My Account Settings page in the Tableau web interface.
  • Token Name: The name of the personal access token.
  • Token Secret: The secret of the personal access token (Only shown once when the token is created)
  • Use credentials Use a credentials variable to supply the token name and token instead.
Authentication Token (Advanced)
Select this option to authenticate using an "Authentication Token". This token must be a valid value for the "X-Tableau-Auth" header. Usually this data is returned by a prior REST call and is temporary so it should be provided with a credentials variable. After use the token will be automatically invalidated. See Tableau REST API - Authentication Concepts for additional information. Note that for this option the "Site Content URL" is not needed.
  • Site Id: The identifier of the site to use.
  • Authentication Token: The authentication token to make API calls to the Tableau server.
  • Use credentials Use a credentials variable to supply the site id and token instead.
Project
The id of the project to publish the extract to. Choose a project by pressing the "Browse..." button.
Data Source
The name of the data source to create on the server.
If file exits...
Specify the behavior of the node in case the output datasource already exists. Overwrite will replace an existing datasource, Append will append the input table to the end of the datasource and Abort will issue an error during the node's execution (to prevent unintentional overwrite).

Input Ports

Icon
Data to be sent to Tableau Server. Only primitive types (string, numbers, dates) are used.

Output Ports

This node has no output ports

Popular Predecessors

Views

This node has no views

Workflows

Links

Developers

You want to see the source code for this node? Click the following button and we’ll use our super-powers to find it for you.