Load Metadata from Tableau Server

Last modified: September 01, 2020

Use the Tableau Loader to upload metadata to Alteryx Connect for Tableau reports located in a specified Tableau server. 

Review Loader Requirements

  • The Alteryx Connect Loaders must be installed on the machine where Alteryx Server is installed. To install the loaders:

    1. Download the loaders installer. For compatibility, the Loaders installer version must match the Alteryx Connect version.
    2. Run the installer as an administrator.
  • Obtain the Tableau web URL (for example, http://tableau.mycompany.com:8000), username, and password.
  • Ensure that the Tableau REST API (v2.5 with Tableau Server 10.2 or later) is enabled. The REST API is enabled by default.

SSO and Tableau 

When the Tableau REST API is enabled, you cannot use SAML single sign-on (SSO) credentials while the Tableau Loader app is running, even if the Tableau server is configured to use SAML. You must specify the user name and password of a user configured on the Tableau server. The Loader has access to Tableau report metadata based on the permissions of the user you specify.

  • To obtain metadata about workbook users, Tableau permissions must be set to administrator or site administrator.

Open the Loader

  1. Open Alteryx Designer.
  2. Select Help > Sample Workflows > Alteryx Connect Metadata Loaders > Tableau Loader > Tableau Loader.

Run the App

  1. Select Run as Analytic App Run as analytic app button.
  2. In the Tableau server tab, type the Tableau connection information.

    1. In the Alteryx Connect tab, type the URL for your Alteryx Connect instance and your credentials. 

    2. Before running the app, select Save button and save the app configuration to the following directory: 

      The .yxwv app values file is used for scheduling the loader to run in the Gallery. See Schedule Metadata Loaders.

  3. Select Finish to run the app.
    • If the run succeeds, "Success" appears in the App Results window.
    • If the run fails, a "There were Errors" message appears.

    Depending on how much metadata is being imported, the app can take a long time to run.

View the Metadata

  1. Go to the Alteryx Connect URL and log in.
  2. From the main menu, select Reports > Tableau.
  3. Select a folder to view its contents.
Was This Page Helpful?

Running into problems or issues with your Alteryx product? Visit the Alteryx Community or contact support. Can't submit this form? Email us.