Customise Tableau Mobile with AppConfig
If you use mobile device management (MDM) or mobile application management (MAM), you can customise Tableau Mobile with app configuration key-value pairs. These key-value pairs are supported by the Tableau Mobile app deployed via MDM and by the Tableau Mobile for BlackBerry and Tableau Mobile for Intune apps for MAM. They are not supported by the Tableau Mobile for Workspace ONE app for MAM.
For information specific to your MDM or MAM system, refer to help from your vendor below.
- BlackBerry UEM help(Link opens in a new window)
- Microsoft Intune help(Link opens in a new window)
- MobileIron help(Link opens in a new window) (Scroll down to “Configuring an iOS managed app”.)
- Workspace ONE help(Link opens in a new window)
- Citrix Endpoint Management help(Link opens in a new window) (formerly XenMobile)
AppConfig keys
Note: Android Enterprise is required to use app configuration key-value pairs on the Android platform.
Key | Example Value | Description |
---|---|---|
AppServiceHosts (string) | https://tableau.example.com ,
| Displays a list of servers for users to choose from during sign-in. Separate the servers with commas. |
AppServiceHostLabels (string) | Website Metrics,
| Specifies the displayed names for AppServiceHosts entries. Separate the names with commas. |
CustomHostsTitle (string) | My Company's Tableau Servers | Sets the title for the list of default servers that appear at sign-in. If you don't specify this value, "Custom Servers" is displayed. |
DisableAppUsageUploads (boolean) | True | Prevents app usage data and crash logs from being sent to Tableau. For details about how Tableau collects and handles usage data, see Tableau Product Usage Data(Link opens in a new window). |
DisableCopyPaste (boolean) | True | Prevents users from copying content from Tableau Mobile and pasting external content into Tableau Mobile. Also prevents users from downloading data and copying links in order to share content. |
DisableDataDownload (boolean) | True | In workbooks accessed on mobile devices, disables the View Data option for tooltips, as well as all options in the Download menu (Image, Data, Crosstab and PDF). Tip: To set download permissions that apply to mobile and desktop devices, use the standard Tableau administrative options(Link opens in a new window). |
DisablePasswordAutofill (boolean) | True | Prevents the use of iOS's Password AutoFill feature, even if the setting is enabled on the device. |
HideServerNameField (boolean) | True | Prevents users from typing a server name during sign-in. Tableau Mobile also supports the previous name of this key, "RestrictServers". |
OverrideDeviceBrowser (string) | Safari (iOS only), OS Default (uses iOS or Android default), Edge | Changes the browser used for authentication when RequireSignInWithDeviceBrowser is set to true. For more information, see Override the default browser used for authentication. |
RemoveTableauOnlineButton (boolean) | True | Removes the Tableau Cloud button from the sign-in options. |
RequireAppLock (boolean) | True | Enforces an app lock, which requires users to open the app using biometrics or a passcode. Tip: For Server versions 2019.4 and later, you can also enforce app lock with a site setting. See Enable app lock for added security. If either the site setting is enabled or RequireAppLock is set to true, an app lock will be enforced. |
RequireSignInWithDeviceBrowser (boolean) | True | Allows Tableau Mobile to use the device’s browser (Safari, Chrome) for authentication. Needed for OpenID Connect/Google and mutual SSL authentication methods. For more information, see Authentication with the device browser. Overrides the user setting ‘Sign in with Device Browser’. |
Example structure for an XML property list
MobileIron, Citrix Endpoint Management and Microsoft Intune use XML property list (.plist) files to set AppConfig values. Below is an example XML structure that uses some of the key-value pairs supported by Tableau Mobile. You can copy this example and customise it for your organisation.
<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd"> <plist version="1.0"> <dict> <key>AppServiceHosts</key><string>tableau.example.com,tableau.example-sales.com</string> <key>AppServiceHostLabels</key><string>Website Metrics,Sales Analytics</string> <key>RemoveTableauOnlineButton</key><true/> <key>RestrictServers</key><false/> </dict> </plist>