Updating Mobile app configuration properties for HCL Connections 7 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.
- Use the WAS Administration console to add Mobile Administration users to the admin role under the Mobile Administration enterprise application deployment.
- 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.
- 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
- 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.
- 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.
- 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.
- 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
- 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.
- Type values from most secure to least secure:
- Complex
- Alphanumeric
- Alphabetic
- 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.