安装 Tableau Desktop 和 Tableau Prep Builder 之后

  • 版本 :2022.1 及更高版本

成功安装 Tableau Desktop 或 Tableau Prep Builder 后,在安装过程中启用的功能和设置可能不适用于您的环境。例如,您可能希望禁用 Tableau Desktop 中的错误报告或自动更新功能。 查看本节中的文章,了解有关如何在安装完成后关闭功能或选项的说明。如果您在安装产品时遇到任何问题,还可以找到故障排除提示。

安装 Tableau Desktop 和 Tableau Prep Builder 时,默认情况下会打开一些功能。例如,使用 Tableau Desktop,自动产品更新或自动保存用户工作簿的功能将作为安装的一部分包含在内。但是,您可能具有一些不希望用户访问的功能,例如上传故障转储文件和日志的功能。作为管理员,您可以关闭其中一些功能。

对于 Windows,还可以将自定义内容配置为显示在“发现”窗格中,将默认示例工作簿替换为自定义工作簿,以及在安装过程中关闭某些功能。有关这些功能的列表,请参阅从命令行安装 Tableau Desktop 和 Tableau Prep Builder 中的安装程序属性

对于 Mac,您可以配置自定义发现窗格内容,将默认示例工作簿替换为自定义工作簿,或者仅在安装后关闭某些功能。若要为“发现”窗格配置自定义内容、将示例工作簿替换为自定义示例或在安装后更改设置(Windows 和 Mac),可以更改注册表或文件,然后重新启动应用程序以查看所做的更改。.plist

若要将更改部署到远程计算机,可以从注册表 (Windows) 或 .plist (Mac) 文件中导出设置,修改要关闭的设置,然后使用修改后的文件创建自动脚本,将更新推送到安装了 Tableau Desktop 的每台计算机。

重要提示:在对注册表文件进行任何更改之前,请始终对其进行备份。错误地编辑 Windows 注册表可能会对您的计算机产生有害影响。

配置“发现”窗格以显示自定义内容(仅限 Tableau Desktop)

默认情况下,Tableau 在 Tableau Desktop 的“发现”窗格中提供培训、博客文章和公共可视化的链接等信息,以帮助您的用户开始使用 Tableau。“发现”窗格在启动时显示,并保留在“开始”页上,以便这些链接和信息始终触手可及。

但是,您可能希望使用“发现”窗格来显示特定于您的组织的内容。为此,您可以为使用启用了 https 的 URL 提供的 Web 服务器上托管的内容创建自己的网页,然后使用 DiscoverPane 密钥和 DiscoverPaneURL 值将 Tableau 提供的默认内容替换为自定义网页中的内容。

注意:为获得最佳效果,请勿使用包含 javascript 或重定向的网页。

为了帮助您快速入门,Tableau Desktop 提供了模板(链接在新窗口中打开)该模型的布局与 Tableau 提供的“发现”窗格的布局相同。只需下载模板并将链接替换为您的自定义内容即可。该模板包括一个指标、布局结构和内容链接部分。

Windows

You can configure the Discover pane to point to your custom web page during install when installing using the command line by adding the property to the command line. If you want to configure the Discover pane to use your custom content after install is complete, then follow the steps below. Restart the application to see your changes. DISCOVERPANEURL="

  1. As an administrator on the computer where Tableau is installed, make a backup of the registry file before you make any changes to it.

  2. Open the registry editor ().regedit.exe

  3. Navigate to the following registry path:

    Computer\HKEY_LOCAL_MACHINE\SOFTWARE\Tableau\Tableau. For example Computer\HKEY_LOCAL_MACHINE\SOFTWARE\Tableau\Tableau 2020.1

  4. Right-click on your Tableau version and select New > Key and name it DiscoverPane.

  5. In the right pane for the new DiscoverPane key, right-click and select New > String Value and name it DiscoverPaneURL.

  6. Right-click on the new DiscoverPaneURL string value and select Modify. Then in the Edit String dialog, in the Value data field, enter the URL for your custom web page. You content must be hosted using an https enabled URL. Using an http enabled URL isn't supported.

    For example .https://help.tableau.com/current/desktopdeploy/en-us/desktop_deploy_user.htm

  7. To reset the Discover pane back to the Tableau Desktop default content, modify the DiscoverPaneURL value and clear the custom web page URL that you entered, leaving theValue data field blank. When you restart Tableau Desktop the Discover pane will show the default Tableau content.

Mac

Modify the /Users/

  1. Set the value to your custom URL by running the following command from the Terminal command prompt. Use the same capitalization as shown below.

    defaults write com.tableau.Tableau-

    For example, in Tableau Desktop 2020.1, use this command:

    defaults write com.tableau.Tableau-

  2. To reset the Discover pane back to the Tableau Desktop default content, run this command:

    defaults write com.tableau.Tableau-

    When you restart Tableau Desktop the Discover pane will show the default Tableau content.

Replace sample workbooks with custom workbooks (Tableau Desktop only)

By default, Tableau provides three sample packaged workbook files to help users explore Tableau. Starting in version 2021.3, you can create up to 5 packaged workbooks targeted to your specific users and replace the sample workbooks Tableau provides on the Start page, Sample Workbooks section with your custom workbooks.

Note: When installing Tableau Server, you can choose to include sample workbooks in the Default site. If you checked the Include samples option during installation, you can publish custom sample workbooks from Tableau Desktop to the Tableau Samples project on your server.

Custom sample workbooks must meet the following requirements:

  • You can include a maximum of 5 sample workbooks at one time.

  • Only packaged workbook (.twbx) files are supported.

  • Workbooks must be stored in directory on a local machine that Tableau and the user has Read access to. Network directories are not supported.

  • Workbook file names cannot contain the characters ', ", <, >, or &.

Note: Custom samples aren't persisted when upgrading to a new release version (for example 2021.4). You'll need to specify the file path for your custom samples when installing your upgrade via the command line or modify the registry (Windows) or .plist (MacOS) post upgrade.

Before you start

Windows and Mac

Create a directory on your local machine where the samples are stored and add up to 5 sample packaged workbook (.twbx) files.

You can replace workbook files as needed, but 5 is the maximum number of workbooks that can be shown on the Start page. For information about replacing custom workbooks, see Manage custom workbooks.

Windows

From the command line

When installing from the command line, add the property .CUSTOMSAMPLESDIR="path to directory"

For example: tableauDesktop-64bit-2021-3-0.exe /quiet /norestart ACCEPTEULA=1 CUSTOMSAMPLESDIR="C:\Users\mkim\Documents\My Tableau Repository\CustomSamples"

When you launch Tableau, you should see your custom samples on the Start page.

Post install from the registry

To configure the custom samples directory after install is complete, follow the steps below. Restart the application to see your changes.

  1. As an administrator on the computer where Tableau is installed, make a backup of the registry file before you make any changes to it.

  2. Open the registry editor ().regedit.exe

  3. Navigate to the following registry path:

    Computer\HKEY_LOCAL_MACHINE\SOFTWARE\Tableau\Tableau. For example Computer\HKEY_LOCAL_MACHINE\SOFTWARE\Tableau\Tableau 2021.3

  4. Create a new folder named Samples. Right-click on the Tableau version folder, select New > Key then rename the new folder.

  5. Right-click on the Samples folder that you just created and select New > String Value and name it CustomSamplesDir.

  6. Right-click on the new CustomSamplesDir string value and select Modify. Then in the Edit String dialog, in the Value data field, enter the full Windows file path to the directory that you set up previously.

  7. Restart Tableau Desktop to see your changes.

  8. To reset the sample workbooks to the Tableau Desktop default content, modify the CustomSamplesDir value and clear the directory path that you entered, leaving theValue data field blank. When you restart Tableau Desktop the Sample Workbooks section on the Start page will show the default Tableau content.

Mac

Modify the /Users/

  1. Set the value to your custom samples directory by running the following command from the Terminal command prompt. Use the same capitalization as shown below.

    defaults write com.tableau.Tableau-

    For example, in Tableau Desktop 2021.3, use this command:

    defaults write com.tableau.Tableau-2021.3.0 Samples.CustomSamplesDir "/Users/mkim/Documents/My Tableau Repository/CustomSamples"

  2. To reset the sample workbooks back to the Tableau Desktop default content, run this command:

    defaults write com.tableau.Tableau-

    When you restart Tableau Desktop the Discover pane will show the default Tableau content.

Manage custom workbooks

When you add custom sample workbooks to Tableau Desktop, a custom.manifest file and worksheet thumbnail images are automatically generated in the custom samples folder that you created when you first open the application.

When replacing custom sample workbooks with new workbooks, you'll need to delete the custom.manifest file so a new file can be generated. Deleting the worksheet thumbnail images is optional.

  1. Navigate to the custom samples folder in your local directory.

  2. Delete the custom.mainfest file.

  3. Delete or move the workbooks and any worksheet thumbnail images (optional) for those workbooks from the custom samples folder.

  4. Add your new packaged (.twbx) workbooks to your custom samples folder.

  5. Restart the application.

Turn off product updates (Tableau Desktop only)

The Product Updates feature lets users receive product updates automatically or check for and install maintenance updates as they become available. To turn off Product Updates after Tableau Desktop is installed, you must update the key in the registry (Windows) or in the file (Mac) for each computer where Tableau is installed. AutoUpdateAllowed.plist

Windows

  1. As an administrator on the computer where Tableau is installed, make a backup of the registry file before you make any changes to it.

  2. Open the registry editor ().regedit.exe

  3. Set the registry key to . The following table lists the location of the key for different products.AutoUpdateAllowed0

ProductLocation (64-bit Tableau and Windows)

Tableau Desktop

HKEY_LOCAL_MACHINE\SOFTWARE\Tableau\Tableau \AutoUpdate

Tableau Public

HKEY_LOCAL_MACHINE\SOFTWARE\Tableau\Tableau Public \AutoUpdate

Tableau Reader

HKEY_LOCAL_MACHINE\SOFTWARE\Tableau\Tableau Reader \AutoUpdate

To enable product updates again, follow the same procedure but set the registry key to instead of .10

Mac

Run one of the following commands from the Terminal command prompt.

PRODUCTCOMMAND
Tableau Desktopdefaults write com.tableau.Tableau- AutoUpdate.AutoUpdateAllowed "0"

For example, in Tableau Desktop 2019.1, use this command:

defaults write com.tableau.Tableau-2019.1 AutoUpdate.AutoUpdateAllowed "0"

Tableau Publicdefaults write com.tableau.Tableau-Public- AutoUpdate.AutoUpdateAllowed "0"
Tableau Readerdefaults write com.tableau.Tableau-Reader- AutoUpdate.AutoUpdateAllowed "0"

To enable product updates again, run the same command but specify instead of .10

Turn off file recovery

The file recovery feature enables Tableau Desktop and Tableau Prep Builder (version 2020.3.3 and later) to save your user's workbooks or flow files so that they don't lose work in the event that the application stops unexpectedly. When the user reopens Tableau, a dialog box is shown with a list of the recovered files to select from. The user can open their recovered files and continue where they left off, or they can delete any files they don't want. If they delete the files, then any changes they made since the last time they saved are discarded.

If they delete all of the recovered files in the list for Tableau Desktop or from the Recovered Flows folder for Tableau Prep Builder, the recovery dialog box no longer shows until new recovered files are generated.

The file recovery feature is enabled by default. If you want to disable it, you can change the setting for the property (Tableau Desktop) or the maestro.appSettings.autosave setting (Tableau prep Builder). Click the tab for your product to view the steps to turn off file recovery.AUTOSAVE

When you turn off the file recovery feature, the Enable Autosave menu option will not be available to the user. If you want to re-enable the feature after install, you can deploy a registry (or .plist for Mac) update to change the property setting for each computer where Tableau is installed. For more information about how to control this setting during install from the command line, see AUTOSAVEInstaller properties(Link opens in a new window).

To turn off file recovery after Tableau Desktop is installed, you must update the key in the registry (Windows) or in the file (Mac) for each computer where Tableau is installed. AutosaveAllowed.plist

Windows

  1. As an administrator on the computer where Tableau Desktop is installed, make a backup of the registry file before you make any changes to it.

  2. Open the Registry Editor ().regedit.exe

  3. Set the registry key to . AutosaveAllowed0

    Registry key location: HKEY_LOCAL_MACHINE\SOFTWARE\Tableau\Tableau \Autosave

To enable file recovery again, follow the same procedure but set the registry key to instead of .AutosaveAllowed10

Mac

Run the following command from the Terminal command prompt.

defaults write com.tableau.Tableau- Autosave.AutosaveAllowed "0"

For example, in Tableau Desktop 2020.3, use this command:

defaults write com.tableau.Tableau-2020.3 Autosave.AutosaveAllowed "0"

To enable file recovery again, run the same command but specify instead of .Autosave.AutosaveAllowed "1""0"

Turn off usage reporting

Tableau collects data that helps us learn how our products are being used so we can improve existing features and develop new ones. All usage data is collected and handled according to the Tableau Privacy Policy(Link opens in a new window). If you don't want to participate in this option, you can opt out during or after install.

For information about the types of data we collect, see Tableau Product Usage Data(Link opens in a new window).

If you don't want to participate in this option, you can opt out by selecting the opt out check box during installation or from the command line (Windows) by adding a command line that includes the property .SENDTELEMETRY="0"

For information about disabling this option in the user interface see Install Tableau Desktop or Tableau Prep Builder from the User Interface(Link opens in a new window). For information about disabling this option from the command line, see Installer options.

Even when you disable the sending of product usage data, certain basic product data is sent to Tableau. If you don't want to send basic product data to Tableau, you can also disable this option. For more information, see Basic Product Data.

To opt out of this option after installation do one of the following:

From the product

  1. Open Tableau Desktop.

  2. From the top menu, select Help >Settings and Performance.

  3. Click on Don't send product usage data.

From the registry

To turn off usage reporting at the system level, follow the instructions for your operating system.

Windows

Open a command prompt and run the following command:

REG ADD "HKLM\Software\Tableau\

Alternatively, follow these steps:

  1. As an administrator on the computer where Tableau Desktop is installed, make a backup of the registry file before you make any changes to it.

  2. Open the Registry Editor ().regedit.exe

  3. Set the registry key to .TelemetryEnabled0

    Registry key location: HKEY_LOCAL_MACHINE\SOFTWARE\Tableau\Tableau \Telemetry

To enable usage reporting again, follow the same procedure but set the registry key to instead of .10

Mac

Run the following command from the Terminal command prompt.

defaults write com.tableau.Tableau- Telemetry.TelemetryEnabled "0"

For example, in Tableau Desktop 2019.4, use this command:

defaults write com.tableau.Tableau-2019.4 Telemetry.TelemetryEnabled "0"

To enable usage reporting again, run the same command but specify instead of .10

Turn off error reporting

If Tableau Desktop or Tableau Prep Builder has a problem and shuts down unexpectedly, crash dump files and logs are generated and placed in the Logs folder in your My Tableau or My Tableau Prep Builder repository. This option is enabled by default.

The data in these files can include machine-specific information, a snapshot of the contents of the memory at the time of the crash (this can include application activity details, data connection information, actions taken by the user or data being worked on in Tableau), and customer-identifiable information.

If your organization is subject to data privacy regulations, you can disable this option. You will need to complete different steps to disable this option for Tableau Desktop versus Tableau Prep Builder. Click on the tabs below to view the instructions for your application.

For Tableau Desktop, the next time the user opens the application, a dialog prompt opens that enables the user to take one of the following actions:

  • Upload the crash files.

  • Decline to upload the crash files.

  • Permanently opt out from uploading the crash files.

If the user uploads the files, they are zipped together into an encrypted package using a 2048-bit RSA key and sent to Tableau so that an engineer can analyze and identify the issues that caused the crash.

The encrypted package includes:

  • Crash dump files (.dmp)

  • Error log files related to the crash (.log)

  • Manifest files related to the crash (.maifest)

If your organization is subject to data privacy regulations, you can disable this prompt from showing by editing the registry (Windows) or running a script (Mac) on each desktop to prevent users from uploading the crash dump files and logs.

Windows

  1. As an administrator on the computer where Tableau is installed, make a backup of the registry file before you make any changes to it.

  2. Open the Registry Editor (regedit.exe)

  3. Set the registry key to .CrashReportUpload2

    Registry key location: HKEY_CURRENT_USER\Software\Tableau\\Prompts

Mac

Run the following command from the Terminal command prompt:

defaults write com.tableau-

For example in Tableau Desktop 2019.1, use this command:

defaults write com.tableau.Tableau-2019.1.plist Prompts.CrashReportUpload -string 2

Turn off Web Page objects for dashboards (Tableau Desktop only)

Web Page objects display targeted URLs in a section of a dashboard. During installation, see Installer properties to disable the display of URLs in these objects. After installation, complete the steps below.

Windows

  1. As an administrator on the computer where Tableau is installed, make a backup of the registry file before you make any changes to it.

  2. Open the Registry Editor (regedit.exe)

  3. Set the registry key to .WebViewToggleWebZonesEnabled0

    Registry key location: HKEY_LOCAL_MACHINE\SOFTWARE\Tableau\\Settings

Mac

Run the following command from the Terminal command prompt.

defaults write /Library/Preferences/com.tableau.Tableau-

For example, in Tableau Desktop 2020.4 use this command:

defaults write /Library/Preferences/com.tableau.Tableau-2020.4.plist Settings.WebViewToggleWebZonesEnabled -integer 0

To enable Web Page objects again, run the same command but specify instead of .-integer 1-integer 0

Disable Dashboard extensions (Tableau Desktop only)

Dashboard extensions expand dashboard functionality with the help of web applications created by Tableau and third-party developers. Starting in Tableau Desktop version 2019.4, Tableau supports two types of dashboard extensions: Network-enabled extensions, which run on web servers that can be located inside or outside your local network and have full access to the web, and Sandboxed extensions, which run in a protected environment without access to the web. For more information, see Use Dashboard Extensions(Link opens in a new window) and Extension Security - Best Practices for Deployment(Link opens in a new window).

Both types of dashboard extensions are enabled by default. If you want to disable dashboard extensions during install on each desktop, set the following properties. For more information, see Installer properties(Link opens in a new window).

  • DISABLEEXTENSIONS="1": Disables all dashboard extension types.

  • DISABLENETWORKEXTENSIONS="1": Disables only Network-enabled extensions. If is set to "0" then users can still use Sandboxed extensions.DISABLEEXTENSIONS

Disable all dashboard extensions after install

To disable all dashboard extensions after install, edit the registry (Windows) or run a script (MacOS) on each desktop using the instructions below.

Windows

  1. As an administrator on the computer where Tableau is installed, make a backup of the registry file before you make any changes to it.

  2. Open the Registry Editor (regedit.exe)

  3. Set the registry key to 1.DisableExtensions

    Registry key location: HKEY_LOCAL_MACHINE\SOFTWARE\Tableau\Tableau

Mac

Run the following command from the Terminal command prompt:

defaults write com.tableau.tableau-

For example in Tableau Desktop 2019.4, use this command:

defaults write com.tableau.tableau-2019.4.plist Settings.Extensions.DisableExtensions "1"

Disable Network-enabled extensions after install

To disable only Network-enabled dashboard extensions after install, edit the registry (Windows) or run a script (MacOS) on each desktop using the instructions below.

窗户

  1. 作为安装了 Tableau 的计算机上的管理员,请在对注册表文件进行任何更改之前对其进行备份。

  2. 打开注册表编辑器 (regedit.exe)

  3. 将注册表项设置为 1。DISABLENETWORKEXTENSIONS

    注册表项位置:HKEY_LOCAL_MACHINE\SOFTWARE\Tableau\Tableau

苹果电脑

从终端命令提示符处运行以下命令:

defaults write com.tableau.tableau-

例如,在 Tableau Desktop 2019.4 中,请使用以下命令:

defaults write com.tableau.tableau-2019.4.plist Settings.Extensions.DisableNetworkExtensions "1"