Updating Mobile app configuration properties for HCL Connections 6.5 CR1 via the Mobile Administration console

Configuration properties control how users can interact with the Connections mobile app.

Perform the following steps to add Mobile Administration Users to the Admin role.

  1. Use the WAS Administration console to add Mobile Administration users to the admin role under the Mobile Administration enterprise application deployment.
  2. Use https://theirconnectionsserver.com/MobileAdmin to access the Mobile Administration console using a mobile administration user they added.

General properties

Show geolocation in activity stream
Displays the geographic location of the user in the activity stream.
Show updates on Home page
Specifies where updates are displayed. Disabling the Display application on home page property hides updates from the Home page. Disabling Show updates on Home page hides updates from the other applications in Connections.
Default application
Specifies the application that is displayed when a user logs in. The default value is Updates.

Other possible values are Activities, Blogs, Bookmarks, Communities, Files, Forums, Profiles, and Wikis. You can also specify an extension application name; for more information, see the Applying extensibility properties topic.

DefaultNavigationOrder
This key controls the initial order of the Connections apps in the main app navigation. The value is a list of Connection app identifiers. Valid values for the Connections apps are updates, communities, files, profiles, favorites, blogs, forums, wikis, offlinefiles, activities, and bookmarks. Also, if you add in application extensions you can specify the application extension unique name in the list. Review Applying extensibility properties for more information.
Remember password
Allows users to save their login password on the mobile device. To prevent passwords from being saved, disable this property; this setting forces users to enter a password each time the Connections app is started.
Allow copy and paste
Allows the copying and pasting of text throughout the application.
Allow iTunes sharing (iOS only)
Allows documents to be shared when you sync your device with iTunes.
Note: This setting does not apply to the application log files.
Allow print (iOS only)
Allows user to print content from the HCL Connections app wherever the print option is available.
Allow email
Enables mailto tags within Connections content. If this option is disabled, mailto tags will still be visible, but clicking the link will result in a message indicating that email from the Connections Mobile app has been disabled.
Allow Account Removal
Enables users to delete accounts on a device without having to first login, which includes deleting accounts that are no longer used or for which the password has been forgotten.

When you enable this property, accounts can be removed from a mobile device without requiring the user to login and without any authorization check. The user is asked to confirm the deletion of an account before it is removed. 

If there are multiple accounts on a mobile device, only the accounts for which Allow Account Removal is enabled can be deleted without having to log in.

On iOS, When Allow Account Removal is enabled, users can swipe to delete the account from the accounts list. If Allow Account Removal is disabled for an account in the account list, a swipe to delete the account does nothing.

Note: If a user has existing accounts that they cannot access and that were created before this feature was available, those accounts cannot be deleted using the Allow Account Removal property. You can set an option in your Mobile Device Management (MDM) to allow the deletion of these accounts. Refer to Mobile Device Management (MDM) for more information.
Enable push notifications
Defines the number of persistent connections to the GCM service. Specify an integer value. The default value is 10.
Require iOS device passcode
This key is only supported on iOS.
This key requires that a device passcode is set before a user can log in to a Connections server. Device passcodes are required in order to enable the data protection encryption feature used by the Connections app. When this key is set to true:
  • A device passcode must be set before the user can log in to an account.
  • If the passcode is removed from the device, data associated with accounts that have been previously used to log in will be wiped.
If your MDM deployment pushes out device configuration profiles to devices, you should set up a passcode profile to enforce setting of the passcode on the device.
Earliest Android App Version
Specifies the minimum level of the Connections Android mobile app that is allowed to connect to the server. The default value is empty, which allows any version of the app to connect to the server.
Earliest iOS App Version
Specifies the minimum level of the Connections iOS mobile app that is allowed to connect to the server. The default value is empty, which allows any version of the app to connect to the server.
Problem Report Email
Specify the email address to use for reporting problems and feedback from the Connections Mobile app. The default email address is heyhcl@pnp-hcl.com.

Activities properties

Enable application
Enables the application by default.
Display application on home page
Allows the application to be displayed in the Home page. When this property is disabled, the application is not visible from the navigation view; however, it is still visible within communities.

Blogs properties

Enable application
Enables the application by default.
Display application on home page
Allows the application to be displayed in the Home page. When this property is disabled, the application is not visible from the navigation view; however, it is still visible within communities.

Communities properties

Enable application
Enables the application by default.
Display application on home page
Allows the application to be displayed in the Home page by default. To hide the application, disable this property. When this property is disabled, the application is not visible from the navigation view.
Access your organization's communities
Allows public communities to be shown. To hide public communities, disable this property.
Allow members to be added
Allows people to be added to a community. Only community owners can add members.
Allow forums to be created
Allows forums to be added to a community. Only community owners can add forums.
Allow file folders
Allows folders that are owned by a community to be displayed.

Files properties

Enable application
Enables the application by default.
Display application on home page
Allows the application to be displayed in the Home page by default. To hide it, disable this property. When this property is disabled, the application is not visible from the navigation view; however, it is still visible within communities.
Allow downloads
Allows files to be downloaded to a mobile device. To prevent downloads, disable this property. Files that are downloaded to a device from within Connections are encrypted using your device's operating system.
Allow uploads
Allows files to be uploaded from a mobile device. To prevent uploads, disable this property.
Allow exports
Allows files to be exported to specific folders on the device. To prevent the exporting of files, disable this property.

This property allows a file to be exported outside of the app's secure container. If this property is disabled, the file cannot be shared with other applications on the mobile device. On iOS, a setting of false would restrict files to being viewed by the built-in viewers. On Android, files would not be downloaded because there is no built-in viewer, meaning that files must be opened outside the app's secure container.

Allow export to device gallery
Allows files to be exported to the device gallery on the device. To prevent the exporting of files to the device gallery, disable this property.
Access your organization's files
Share with other organizations
Allows files to be shared with everyone. To hide files from public view, disable this property.
Share with your organization
Allows public files to be shown. To hide public files, disable this property.
Allow Import
Allows files to be imported from a third party app and uploaded using the HCL Connections app.

When the property is enabled and no whitelist is specified by Import Whitelist, then any third party app can import files into the HCL Connections app.

When the property is disabled:
  • Third party apps cannot import files into the HCL Connections app.
  • Importing photos or videos from the device gallery is not allowed. However, photos can be taken with the camera and imported into the HCL Connections app.
Import Whitelist
Specifies a whitelist, or list of apps, that are allowed to import files into the HCL Connections app. This value is only used if Allow Import is enabled. The default value is no whitelist.

This list is a comma-separated list of app IDs that can import and upload files using the HCL Connections app.

Note: Only supported on iOS. If Allow Import is enabled and a whitelist is specified, then only the 3rd party apps that are listed in Import Whitelist are allowed to import files into the HCL Connections app.

Taking a photo or video inside the HCL Connections app and uploading it is also allowed. To allow importing of photos and videos from the Camera roll, you must specify the Camera app, com.apple.camera, in the whitelist.  To allow importing of photos and videos from the Photos app, you must specify the Photos app, com.apple.mobileslideshow, in the whitelist.

 
Enable sync
Defines whether the File Sync extension is enabled or disabled.
Enable automatic Sync
Defines whether File Sync automatically synchronizes files. Specifies whether a user can designate a file to be synchronized automatically. If this property is disabled, users must sync files manually. If the property is enabled, users can decide to specify manual or automatic synchronization. In this case, the default is automatic synchronization.
Enable File Differential
Defines whether the File Diff function is enabled. File Diff computes the difference between any two versions of a file by using the rsync algorithm.

GeoLocation Reporting

When geolocation reporting is configured, everyone in the organization, regardless of their roles, has their location reported by the HCL Connections app.
Report Location
Enables and disables geolocation reporting. The default value is disabled reporting.
Reporting URL
The URL used by the HCL Connections app to post the GPS coordinates. If a URL is not specified, geolocation reporting is disabled. The URL must point to a servlet that accepts a POST request. The POST request contains the following parameters that are formatted as json:
userName
The display name for the user.
userId
The user ID that is used to log in to the HCL Connections server.
userLat
The latitude of the user's location.
userLong
The longitude of the user's location.
An example of body data is shown in the following code:
{"userName":"Amy Jones","userId":"ajones@mycompany.com","userLat":22.5780445,"userLong":88.48662609999997}
Reporting Type
If you specify Time, GPS coordinate updates are based on changes in time.
If you specify Distance, GPS coordinate updates are based on changes in location.
If Reporting Type=Time, specify how often, in minutes, the current GPS location is to be reported. The minimum time is 7 minutes. Any setting shorter than 7 minutes is automatically set to 7 minutes.
If Reporting Type=Distance, specify how much the location needs to change, in meters, before a GPS location update is reported. The minimum distance is 500.
Report Frequency
If Reporting Type=Time, specify how often, in minutes, the current GPS location is to be reported. The minimum time is 7 minutes. Any setting shorter than 7 minutes is automatically set to 7 minutes.
Note:
  1. The HCL Connections app must be running and logged in to the account where GPS reporting is enabled. When the user switches to another account or logs out of the account, the GPS reporting is stopped. On Android, if a user backs out of the HCL Connections app, GPS reporting stops.
  2. On iOS, for the GPS location information to be reported successfully, the end user must allow the HCL Connections app to access location information and allow the HCL Connections app to access location information when running in the background. The HCL Connections app cannot control the specific time that iOS schedules the update when running in the background. Therefore, when using Reporting Type=Distance, the reporting time might not be exact on iOS.
     

Customization Settings

Enable Customization
App customizations are disabled by default. To enable them, enable this property.
Theme color
Allows you to customize the main app theme color of the HCL Connections app. The value is a 6 character string that represents a hexadecimal color code. The default value is blank.

HCL Connections app colors are tied to the account. When a user logs out, the theme colors revert to the colors that are shipped with the HCL Connections app. When a theme color is not specified using Theme color, the theme colors shipped with the HCL Connections app are used.

Note: If an MDM is used to set this value, it overrides this Theme color setting.
Note: If a value is not specified for the Foreground color or Theme color property, the default app color is used.
Note: Theme color is only supported on iOS and Android.
 
Foreground color
If you customize the HCL Connections app theme color using Theme color property, Foreground color allows you to customize the color of the text and icons that are displayed in areas where the theme color is shown. The value is a 6 character string that represents a hexadecimal color code. The default value is blank.
Note: If an MDM is used to set this value, it overrides this Foreground color setting.
Note: If a value is not specified for the Foreground color or Theme color property, the default app color is used.
Note: Foreground color is only supported on iOS and Android.
 

The following list shows an example of customized properties:

App Password Settings

Use these properties to set an app password policy that is enforced by the mobile clients. If an app is managed by an MDM, then the Enable App Password policy has no effect. MDM policies can be set up to require an app password.
Enable App Password
Enable or disable the app password policy.
Type
Required. Valid values include:
Numeric
Password can only contain numeric characters.
Alphabetic
Password can contain alphabetic characters and symbols but no numeric characters.
Alphanumeric
Password must contain at least one alphabetic character and one numeric character.
Complex
Password must contain at least one alphabetic character, one numeric character, and one special character.
Min Length
Optional. The minimum length requirement for the password.
If Type is set to Numeric:
  • On iOS, MinLength is set to 4.
  • On Android, valid values for MinLength range from 4 to 8.
Min Letters
Optional. The minimum number of letters required for a complex password. This only applies to Complex password types. The default value is 1.
Min Numeric
Optional. The minimum number of numeric characters required for a complex password. This only applies to Complex password types. The default value is 1.
Min UpperCase
Optional. The minimum number of uppercase letters required for a complex password. This only applies to Complex password types. The default value is 0.
Min LowerCase
Optional. The minimum number of lowercase letters required for a complex password. This only applies to Complex password types. The default value is 0.
Min Symbols
Optional. The minimum number of symbols required for a complex password. This only applies to Complex password types. The default value is 1.
Auto Lock
Optional. A timeout value, in minutes, that requires the user to re-enter their password if no activity has taken place for the time period that is defined in this property. The default value is 0 (no autolock).
History
Optional. The number of unique passwords required before reuse of a password is allowed. The default value is 0 (no history maintained).
Wipe Failures
Optional. The number of times a user can enter an incorrect password before all data for the app is removed from the device. The default value is 0 (no wipe).
Expiration
Optional. The number of days that a password can be used before the user is required to change it. The default value is 0 (no password expiration).
AllowSequences
Optional. Indicates if the password can contain ascending, descending, or repeating characters. Valid values include true and false. If set to false, the password cannot contain any repeating characters or 3 or more ascending or descending characters. The default value is true.
AllowTouchID
Optional. When enabled, and if the iOS device supports fingerprint recognition, users can unlock the HCL HCL Connections app using Touch ID without having to enter their HCL HCL Connections app password. Valid values include true and false. The default value is false, which disables using Touch ID.
 
When you set an app password policy, the policy is activated when a user creates an account and logs into that server. A user can create multiple accounts to different servers with different password policy settings. If there are different password policy settings, the most secure settings are in effect for the app.
  • Type values from most secure to least secure:
    1. Complex
    2. Alphanumeric
    3. Alphabetic
    4. Numeric
  • The largest MinLength setting takes effect.
  • The smallest Autolock setting takes effect.
  • The smallest Expiration setting takes effect.
  • The largest History setting takes effect.
  • The smallest WipeFailures setting takes effect.
  • AllowSequences=false overrides AllowSequences=true.
  • AllowTouchID=false overrides AllowTouchID=true.

Mobile Server application Management Settings

To enable security management of the HCL® Connections native apps, enable the Require Mobile Server application Management property. For more information about administering security for the Mobile Server application, see the Configuring security for mobile topic.

Require Mobile Server application Management
Mobile security administration is disabled by default. To enable it, enable this property.