Cognos Analytics Reports service configuration settings

These settings are used to administer the delivery of IBM® Cognos® Analytics content to IBM Cognos Analytics Reports applications.

Policy settings

These settings define how to deliver Cognos Analytics content to Cognos Analytics Reports.

Maximum number of pages to store for each report
Pages over the specified limit are automatically discarded from the device.

Default: 5

Tip: If your Cognos Analytics Reports environment includes only native clients, set up the default to 50 pages. Otherwise, use the suggested default of 5.
Maximum number of days to store a report
Specifies the maximum time, in days, that a report is stored in the database. Reports that exceed this limit are automatically removed from the device.

Value: 1 to 999

Default: 30

Maximum number of hours between runs of the source and target reports
Specifies, in hours, the maximum amount of time allowed between the runs of the source and target reports when using the application drill-through feature with active reports in the iOS native app. When the difference between the two runs exceeds this amount, the application drill-through target is not used.

The default value of 1 means that as long as the target report was run within 1 hour after the source report was run, the target report can be opened successfully.

The value of 0 disables the application drill-through functionality. When running the source report after the target report using this value, the target report does not open and an error message is displayed. The error message states that the target report does not exist and needs to be run first.

This setting is not applicable for the Android native app.

Permission to share report screen captures
Allows or disallows the users of a native client to share screen captures of the reports that they are viewing. Users can share report screen captures by email or by other methods.

Value: True or False

Default: True

Cognos Analytics Reports root folder
Specifies the name of the root folder that Cognos Analytics Reports users must start from when browsing or searching content from a mobile device.

Default: blank

The value for this setting must be the Content Manager search path in the following format: /content/package[@name='<root_folder_name>'].

If the setting is blank, Cognos Analytics Reports uses the root content folder or the root folder that is specified in the portal system.xml file stored in the install_location/templates/ps directory. If you add a root folder, use the syntax of the consumer-root setting in the system.xml file.

Tip: To find the search path in IBM Cognos Analytics, view the properties of the package or folder that you want to use as the Cognos Analytics Reports root folder. Then, click View the search path, ID and URL.
Mobile theme support
Specifies if custom mobile themes are supported for the Cognos Analytics Reports web application.

Values: themesOn and themesOff

Default: themesOff

Maximum number of hours to access Mobile local data stored on a device
Specifies the maximum number of hours when users of mobile devices can access the Cognos Analytics Reports local data stored on a device.

Value: 0 to 8760

Default: 36

The value of 0 disables the lease key mechanism.

Maximum number of hours to store cached credentials
If you do not want to store credentials on a device, type 0. To store credentials on a device, type any value that is greater than the current timeout setting for IBM Cognos Analytics. As long as users are logged on, they will have access to their cached credentials.

Value: 0 to 8760

Default: 0

Maximum number of hours that the client can remain out of date with scheduled reports
This setting applies to the cases where an administrator schedules reports for a user on the server and the user does not otherwise communicate with the server before the time expires, for example, to retrieve other reports or to browse the IBM Cognos Analytics portal. In the majority of cases, such as when reports originate from existing schedules or from user-initiated actions, this setting will not be a factor because, typically, the device lags behind the server by only seconds.

Value: 0 to 999

Default: 24

The value of 0 pushes reports to be downloaded on devices immediately.

Security settings

These settings are used to secure the Cognos Analytics Reports application.

Local storage encryption level for IBM Cognos Analytics Reports applications
Specifies the method by which data that is stored on iOS or Android devices is encrypted.

Values: NONE, AES128, AES256

Default: AES128

Tip: The web application does not store data locally and is not affected by this setting.
Security code session timeout in seconds
Specifies the need for a security code when accessing the Cognos Analytics Reports application and the maximum number of seconds that the application can remain inactive. The security code cannot contain consecutive or repeated numbers.

Value: 1 to 8760

Default: -1

A value of -1 means that no security code is needed. A value of 0 means that the user must create a security code and enter it every time to access the app.

A value greater than 0 indicates that the user must create a security code and can leave the app inactive for the number of seconds specified in the setting before needing to reenter the code to use the app. For example, if the value is set to 60, the user must enter a security code and can leave the Mobile app inactive for 60 seconds.

Maximum number of attempts to enter a security code when accessing the Cognos Analytics Reports application
Specifies the maximum number of times that users can try to enter their security code when accessing the Cognos Analytics Reports application.

Value: 1 to 99

Default: 10

Notification settings

These settings are used to configure Apple push notifications.

Support for Apple push notifications
Enables Apple push notifications for the iOS native app, and specifies the wording of the message that is displayed to the iOS device users. The values are:
  • None - Apple push notifications are disabled and messages are not sent from the server to the Apple Push Notification Service.
  • Name - Apple push notifications are enabled. The messages sent from the server to the Apple Push Notification Service include the report name.
  • Generic - Apple push notifications are enabled. The messages sent from the server to the Apple Push Notification Service do not include the report name. Instead, a generic message is displayed.

Default: Name