Key-value pairs to configure app behavior
Table 1. key-value pairs to configure app behavior
Key |
Value: Enter/Select one |
Description and Value |
Specifies the level of detail for logs |
||
log_level |
|
Select one of the following:
|
Email logs |
||
support_email_id |
Enter a valid email address. |
Automatically populates the email address when the device user emails the device logs. |
Disallow adding some document storages |
||
blocked_storage_domains |
Enter one or more of the following:
|
Blocks device users from adding the content site to Docs@Work: Enter the values as a semicolon (;) separated list. Example: Box Dropbox;CIFS Microsoft SharePoint includes Office 365 SharePoint sites. |
Disallow adding user sites |
||
disable_user_sites |
|
Prevents device users from adding sites to Docs@Work. User added sites will be removed. Documents from User sites marked as Starred, Offline or in Recents will be removed. |
Restrict number of allowed user sites |
||
restrict_number_of_user_sites |
Connector type: Number of sites that are allowed. For example: SharePoint:2, Box:1 |
Restricts the number of User sites that a device user can add. If a site type is not configured, there are no restrictions on the number of User sites for that site type. Restricting number of User sites has no impact on blocked sites. This key-value pair only applies to allowed sites. The configuration is ignored if DISABLE_USER_SITES is true. Enter the following value: •site type and number in the following format: Site type1:number; Site type2:number. Valid entries for site type are: SharePoint, Box, Dropbox, WebDAV, CIFS. Number is a positive integer greater than 0. Example: SharePoint:2; Box:1 In this example, the device user will be able to add up to two SharePoint sites, and only one Box site. There are no restrictions on any other type site. |
Allows sending analytics from Docs@Work to Mixpanel |
||
allow_analytics |
|
Use the following values to set the key-value pair:
The default value is set to True. |
Disables editing, importing, and uploading files |
||
disable_editing |
|
Disables the following in My Files and all content sites in Docs@Work:
|
Automatically populates the user name for the content site. |
||
AUTOFILL_CREDENTIALS |
Enter parameters for the content site in the following JSON format: {"URL": {"domainType":"DomainType","userName":"$USERID$","password":"$PASSWORD$"},"default":"Domain/$USERID$"} For JSON format:
|
URL: Enter the URL for the content site. Include the protocol. Example: http, https. Domain Type: Enter one of the following: SharePoint, WebDAV, Box, BoxEnterprise, CIFS. Domain: Enter the domain name to which the username defaults if the username for the URL cannot be resolved. Variables are not supported. Password: The user is directly logged in to the Site from the Sites screen. This feature is applicable for CIFS and WebDAV sites only on Core. $PASSWORD$ value will be available only when admin enables "Save User Password" in device registration settings on Core and user registered Mobile@Work client after that. Refer to Coredocumentation for its usage. Examples:
|
Displays watermark text on the fies and folders |
||
watermark_text |
Use a user identifying variables as values such as, $USERID$ and $EMAIL$. |
Displays a diagonal watermark text (provided by the administrator) over all the documents viewed or edited using Docs@Work. |
Displays the title of files and folders in SharePoint |
||
show_title |
|
Displays user friendly title for files and folders in Sharepoint. Use the following values to set the key-value pair:
The default value is set to False. |
Sets box metadata cache expiry |
||
box_metadata_timeout |
Default value: 15 minutes |
Box metadata for a particular folder is cached whenever response is received from server. This cached metadata expires after timeout and if a new request for metadata comes for the same folder, it is sent to BOX server. Duration in minutes after which box metadata cache expires. |
ENABLE_POLARIS_VIEWER |
|
Enables the embedded viewer in Docs@Work for viewing files. Enter the following value: •Yes. |
MAILTO_PREFIX |
|
Opens a mailto: link in Email+. If this key-value pair is not configured, tapping on a mailto link does not bring up any email client. Enter the following value: •email+launcher://docsatwork?url=mailto: |
HTTP_PREFIX |
|
Allows users to tap on a URL starting with http:// and view the site in a browser. If the key-value pair is not configured, users will not be able to view an http link in a browser. If the key-value pair is not configured, http:// links are not opened in any browser. Ivanti recommends that both HTTP_PREFIX and HTTPS_PREFIX are configured. If only one URL scheme is configured, the unconfigured URL scheme will not be opened in any browser thus impacting user experience. Enter one of the following values: •mibrowser URLs starting with http:// are opened in Web@Work. •http URLs starting with http:// are opened in Safari. |
HTTPS_PREFIX |
|
Allows users to tap on a URL starting with https:// and view the site in a browser. If the key-value pair is not configured, users will not be able to view an https link in a browser. If the key-value pair is not configured, https:// links are not opened in any browser. Ivanti recommends that both HTTP_PREFIX and HTTPS_PREFIX are configured. If only one URL scheme is configured, the unconfigured URL scheme will not be opened in any browser thus impacting user experience. Enter one of the following values: •mibrowsers URLs starting with https:// are opened in Web@Work. •https URLs starting with https:// are opened in Safari. |
APPLY_SSO_LABEL |
|
Changes the NoAuthn label to Corporate single sign-on (SSO) in Docs@Work. The NoAuthn option is seen in the Authentication settings for SharePoint sites in Docs@Work. There is no functional change. Enter the following value: •true |
ENABLE_PDF_DOCUMENT_DEFINE |
|
Makes the Define option available for PDF documents, regardless of whether Copy/Paste is enabled in AppConnect policy. Enter the following value: •true |
ENABLE_POLARIS_DOCUMENT_CONTENT_SHARE |
|
Makes the Share option available for PDF documents, regardless of whether Copy/Paste is enabled in AppConnect policy. Enter the following value: •true |
ENABLE_WEBVIEW_AUTHENTICATION |
|
Use this key-value pair if the Sharepoint server is not set up to use persistent authentication cookies and users encounter issues with opening WebView for SharePoint sites. Enter the following value: •true |
Allow digital signature for PDF |
||
signing_certificate |
Certificate |
This key allows the admin to add signing certificate which is used for digital signature for PDF forms for Android AppConnect. To enable digital signature add configure signing certificate, add signing_certificate key and select the signing certificate from drop-down menu. Only one signing certificate is supported and it should be in .p12 format. It needs to be added as certificate enrollment configuration. |
signing_certificate_ca_n |
Certificate |
This key allows the admin to add multiple Certificate Authorities to trusted CA’s. The certificate must be DER-encoded. Where, the value of n can be from 0 to 9. For example: signing_certificate_ca_0, signing_certificate_ca_1 |
Default viewer for PDF files |
||
|
|
This key allows the admin to change default viewer for PDF files. If set to true, this enhances user interface experience and also supports digital signature feature. |
Grouping of Offline files |
||
group_offline_files |
|
This key allows files under offline section to be grouped under folder path header. The default value is set to False. |
Miscellaneous |
||
ENABLE_CIFS_RETRY_ON_SHARING_VIOLATION |
|
This key allows the admin to resolve an issue where CIFS would cause a sharing violation error, when you try to open a file which was already opened/updated on desktop. |