# tTableauOutput

Writes data to a data source on a Tableau server. This component requires Tableau Server 2020.3 (and later versions) and requires that Tableau REST API be enabled on the Tableau server. See [REST API](https://help.tableau.com/current/api/rest_api/en-us/REST/rest_api_requ.htm) for related information.

This component is not shipped with your Talend Studio by default. You need to install it using the Feature Manager. For more information, see [Installing features using the Feature Manager](https://help.qlik.com/talend/r/en-US/8.0/studio-user-guide/install-features-to-talend-studio).

## tTableauOutput Standard properties

These properties are used to configure tTableauOutput running in the Standard Job framework.

The Standard tTableauOutput component belongs to the Business Intelligence family.

The component in this framework is available in all subscription-based Talend products.

Information noteNote: This component is available only when you have installed the 8.0 R2022-02 Talend Studio Monthly update or a later one delivered by Talend. For more information, check with your administrator.

## Basic settings

| Properties | Description |
| --- | --- |
| Property type | Either Built-In or Repository.<br><br><br>Built-In: No property data stored centrally.<br><br><br>Repository: Select the repository file where the<br>properties are stored. |
| URL | Enter the Tableau server URL. |
| Site | Enter the site URL. On a Tableau server, users, groups, and contents are<br>grouped in sites. See [What is a site](https://help.tableau.com/current/server/en-us/sites_intro.htm) for related<br>information. |
| Authentication | Specify the authentication method for logging into the Tableau server:<br>Basic or Token. |
| Username and<br>Password | Enter the<br>authentication information required to access the server.<br><br>To enter the password, click the [...] button<br>next to the Password field to bring out the Enter a new<br>password dialog box, enter the password in the text field, and click<br>OK. Note that you can enter the password either in a JSON string<br>in the pure password mode or as a Java expression in the Java<br>mode. You can toggle between the two modes by clicking switch to<br>Java mode or switch to pure password mode on the top<br>of the text field.<br><br>Information noteNote:<br><br><ul> <li>The two password modes are available only when you have installed the                  8.0.1-R2022-05 <span>Talend Studio</span>                  monthly update or a later one delivered by <span>Talend</span>. For more information, check with your administrator.</li> <li>If the 8.0.1-R2022-05 <span>Talend Studio</span>                  monthly update or a later one delivered by <span>Talend</span>                  is not installed, you can enter passwords in the <span>Java mode</span>                  only. </li> </ul><br><br>These two fields are available when you select Basic from the Authentication drop-down list. |
| Token name and Token secret | Enter your personal access token name and token secret required to access the<br>server. See [Create and revoke personal access tokens](https://help.tableau.com/current/pro/desktop/en-us/useracct.htm#create-and-revoke-personal-access-tokens) and [Personal<br>Access Tokens](https://help.tableau.com/current/server/en-us/security_personal_access_tokens.htm) for related information.<br><br>To enter the token secret, click the [...] button<br>next to the Token secret field to bring out the Enter a new<br>password dialog box, enter the token secret in the text field, and click<br>OK. Note that you can enter the token secret either in a JSON string<br>in the pure password mode or as a Java expression in the Java<br>mode. You can toggle between the two modes by clicking switch to<br>Java mode or switch to pure password mode on the top<br>of the text field.<br><br>Information noteNote:<br><br><ul> <li>The two password modes are available only when you have installed the                  8.0.1-R2022-05 <span>Talend Studio</span>                  monthly update or a later one delivered by <span>Talend</span>. For more information, check with your administrator.</li> <li>If the 8.0.1-R2022-05 <span>Talend Studio</span>                  monthly update or a later one delivered by <span>Talend</span>                  is not installed, you can enter token secrets in the <span>Java mode</span>                  only. </li> </ul><br><br>These two fields are available when you select Token<br>from the Authentication drop-down list. |
| Project name | Enter the project name. On a Tableau server, a project holds related contents.<br>See [Use Projects to Manage Content Access](https://help.tableau.com/current/server/en-us/projects.htm) for related information.<br><br>To avoid unexpected result, make sure that the project name is unique on the<br>specified site. |
| Schema and Edit schema | A schema is a row description. It defines the number of fields<br>(columns) to be processed and passed on to the next component. When you create a Spark<br>Job, avoid the reserved word line when naming the<br>fields.<br><br><ul> <li> <p> <span>Built-In</span>: You create and store the schema locally for this component                only.</p> </li> <li> <p> <span>Repository</span>: You have already created the schema and stored it in the                Repository. You can reuse it in various projects and Job designs.</p> </li> </ul><br><br>Click Edit<br>schema to make changes to the schema. If the current schema is of the Repository type, three options are available:<br><br><ul> <li> <p> <span>View schema</span>: choose this                option to view the schema only.</p> </li> <li> <p> <span>Change to built-in property</span>:                choose this option to change the schema to <span>Built-in</span> for local changes.</p> </li> <li> <p> <span>Update repository connection</span>:                choose this option to change the schema stored in the repository and decide whether                to propagate the changes to all the Jobs upon completion.</p> <p>If you just want to                propagate the changes to the current Job, you can select <span>No</span> upon completion and choose this schema metadata                again in the <span>Repository Content</span>                window.</p> </li> </ul> |
| Write operation | Select the way in which the data is written to the Tableau server:<br>Create, Append, or<br>Overwrite.<br><br><ul> <li> <span>Create</span>: creates a data source on the Tableau server.                           The operation fails if a data source with the same name already                           exists.</li> <li> <span>Append</span>: appends data to the specified data                           source. The operation fails if the data source specified does not                           exist.</li> <li> <span>Overwrite</span>: removes the specified data source and                           then creates a data source with the same name. If the specified data                           source does not exist, this operation simply creates the data                           source.</li> </ul> |

## Advanced settings

| Properties | Description |
| --- | --- |
| tStatCatcher Statistics | Select this check box to gather the Job processing metadata at<br>the Job level as well as at each component level. |
| Max batch size | Specify the maximum number of data rows that can be written in a<br>batch. |

## Global Variables

| Variables | Description |
| --- | --- |
| Global Variables | NB\_LINE: the number<br>of rows read by an input component or transferred to an output component. This is an<br>After variable and it returns an integer.<br><br><br>ERROR\_MESSAGE: the error message generated by the<br>component when an error occurs. This is an After variable and it returns a string. This<br>variable functions only if the Die on error checkbox is<br>cleared, if the component has this checkbox.<br><br>A Flow variable functions during the execution of a component<br>while an After variable functions after the execution of the component.<br><br>To fill up a field or expression with a variable, press Ctrl+Space to access the variable list and choose the variable to use from<br>it.<br><br>For more information about variables, see [Using contexts and variables](https://help.qlik.com/talend/r/en-US/8.0/studio-user-guide/contexts-and-variables). |

## Usage

| Usage guidance | Description |
| --- | --- |
| **Usage rule** | This component is used as an end component and requires an input link.<br><br>Due to the limitation of Tableau REST API, this component does not support<br>parallel execution. |