Was this page helpful?
Yes No

Troubleshoot Tableau Prep

This article lists problems you might encounter when using Tableau Prep and suggestions for how to resolve them.

In this article

Common errors when using the command line to run flows

You can run flows from the command line to refresh your output files programmatically instead of opening Tableau Prep to run each flow manually. While this process helps build efficiency in your flow process, if your syntax is incorrect, or you are missing credentials for your connections or output locations, you will receive errors when running this process.

The following table describes common errors and how to resolve them. For information about how to run flows from the command line, see Refresh output files from the command line.

Error Cause How to fix it
"Missing arguments" One of the required command line arguments is missing. Use “tableau-prep-cli -help” to see a list of the arguments for the command line.
"Unable to read the connections file." There are errors in the syntax or format in the credentials.json file for the input connections. Check the syntax for the input connections in the .json file. For more information and examples, see Refresh output files from the command line.

"There are errors in the flow. Unable to run the flow.

Check that the credentials .json file includes all required credentials. Open the flow in Tableau Prep to view error details."

There are missing credentials in the credentials.json file for the input connections or the flow has errors.

Check that the .json file has the credentials for all connections, and open the flow file in Tableau prep to see if there are any errors in the flow.

If the flow has errors, you must fix them and republish the flow to Tableau Server, then try running the process again.

"Could not find match for <hostname of inputConnections >" The credentials.json file is missing an entry for the hostname (server name).

Make sure the credentials.json file includes the correct credentials for the hostname (server name).

For more information and examples, see Refresh output files from the command line

"We don't have credentials of all connections in tfl/tflx file. The following connection(s) were not found: <hostname of inputConnections>" The credentials.json file is missing or has incorrect credentials for the hostname(serv er name) shown in the error message.

Make sure credentials.json file includes the correct credentials for the hostname (server name) listed in the error message.

For more information and examples, see Refresh output files from the command line.

"Error signing in server <serverUrl> as a user <userName>. Please check the credentials." The credentials.json file has the incorrect credentials for Tableau Server.

Make sure the credentials.json file includes all the correct credentials and elements for the output connection.

For more information and examples, see Refresh output files from the command line

"Could not sign in successfully as <userName> to server <serverUrl>(<contentUrl>)" The credentials.json file has the incorrect credentials for Tableau Server.

Make sure the credentials.json file includes all the correct credentials and elements for the output connection.

For more information and examples, see Refresh output files from the command line

"We don't have credentials for Tableau Server to publish extract for one or more output nodes in tfl/tflx file." The credentials.json file was not passed in as a command line argument or it is missing the credentials for the output connection.

Make sure the the path to the credentials.json file is included in the command line and verify that the credentials.json file includes all the correct credentials and elements for the output connection.

For more information and examples, see Refresh output files from the command line

"Loom rest api server not started" The installation or environment setup is incorrect.

Make sure that Tableau Prep is installed correctly and that you are running the command as an Administrator.

For information about how to install Tableau Prep, see Install Tableau Prep.

"Error. Flow file does not exist." The path to the flow file is incorrect. Make sure that the correct path to the flow file is included in the command line.
"Error. Connections file does not exist." The path to the credentials.json file is incorrect. Make sure that the correct path to the creedntials.json file is included in the command line.

Error: "These features were found that prevent this version of the application from using this file"

If you open a flow that was created in version 2018.2.1 or later in an earlier version of Tableau Prep, you may see the following error:

Flows that include features that are not supported in earlier releases will result in this incompatibility error. To resolve the error, open the flow in the later version, and save a copy of the flow without the indicated feature. In the above example, remove the null filter from the field where it is applied.

Then open the copy that has the feature removed in the earlier version of Tableau Prep.

(Back to top)


Error: "Failed to parse response from Tableau Server" when publishing Tableau Prep output

To successfully publish output from Tableau Prep to Tableau Server, the REST API must be enabled on Tableau Server. If the REST API is not enabled, you will see the following error:

Failed to parse response from Tableau server due to:javax.xml.bind.UnmarshalException - with linked exception: [org.xml.sax.SAXParseException; lineNumber: 1; columnNumber: 10; DOCTYPE is disallowed when the feature "http://apache.org/xml/features/disallow-doctype-decl" set to true.]

For information about enabling the REST API on Tableau Server, see REST API Requirements in the REST API Help.

For information about publishing output from Tableau Prep, see Create and publish data extracts and data sources.

(Back to top)


Error: "You are using Server version: null..." when signing in to an SSL-enabled Tableau Server using Tableau Prep

When you sign in to an SSL-enabled Tableau Server from Tableau Prep, you must have a root certificate installed on the computer where Tableau Prep is installed. If the certificate is not installed, you might see the following error:

You are using Server version: null but the minimum compatible version is: 10.0. Please upgrade to a compatible version

If you see this error, work with your IT department or system administrator to install the required root certificate on the computer where Tableau Prep is installed. For more information, see System requirements in the Tableau Desktop and Tableau Prep Deployment Guide.

(Back to top)