Reports | Integrations | Cognos [version]

The Unica suite integrates with Cognos to generate reports.

This page displays properties that specify URLs and other parameters that are used by the system.

Integration Name

Description

Read-only. Specifies that IBM Cognos is the third-party reporting or analytical tool that is used by the Unica to display the reports.

Default value

Cognos

Vendor

Description

Read-only. Specifies that IBM Cognos is the name of the company that provides the application that is specified by the Integration Name property.

Default value

Cognos

Version

Description

Read-only. Specifies the product version of the application that is specified by the Integration Name property.

Default value

<version>

Enabled

Description

Specifies whether IBM Cognos is enabled for the suite.

Default value

False

Valid Values

True | False

Integration Class Name

Description

Read-only. Specifies the fully qualified name of the Java class that creates the integration interface that is used to connect to the application specified by the Integration Name property.

Default value

com.unica.report.integration.cognos.CognosIntegration

Domain

Description

Specifies the fully qualified company domain name in which your Cognos server is running. For example, myCompanyDomain.com.

If your company uses subdomains, the value in this field must include the appropriate subdomain as well.

Default value

[CHANGE ME]

Valid Values

A string no longer than 1024 characters.

Portal URL

Description

Specifies the URL of the IBM Cognos Connection portal. Use a fully qualified host name, including the domain name (and subdomain, if appropriate) that is specified in the Domain property. For example: http://MyReportServer.MyCompanyDomain.com/cognos<version>/cgi-bin/cognos.cgi

You can find the URL in IBM Cognos Configuration at: Local Configuration > Environment .

Default value

http://[CHANGE ME]/cognos<version>/cgi-bin/cognos.cgi

Valid Values

A well-formed URL.

Dispatch URL

Description

Specifies the URL of the IBM Cognos Content Manager. Use a fully qualified host name, including the domain name (and subdomain, if appropriate) specified in the Domain property. For example: http://MyReportServer.MyCompanyDomain.com:9300/p2pd/servlet/dispatch

You can find the URL in Cognos® Configuration at: Local Configuration > Environment .

Default value

http://[CHANGE ME]:9300/p2pd/servlet/dispatch

9300 is the default port number for the Cognos Content Manager. Be sure that the port number specified matches that used in the Cognos installation.

Valid Values

A well-formed URL.

Authentication mode

Description

Specifies whether the IBM Cognos application is using the Authentication Provider, which means it relies on the Unica Platform for authentication.

Default value

anonymous

Valid Values
  • anonymous: means that authentication is disabled.
  • authenticated: means that the communications between the system and the Cognos system are secured at the machine level. You configure a single system user and configure it with the appropriate access rights. By convention, this user is named "cognos_admin."
  • authenticatedPerUser: means that the system evaluates individual user credentials.

Authentication namespace

Description

Read only. The namespace of the Authentication Provider.

Default value

UNICA

Authentication user name

Description

Specifies the login name for the reporting system user. The applications log in to Cognos as this user when Cognos is configured to use the Unica Authentication provider. This user also has access to Unica.

This setting applies only when the Authentication mode property is set to authenticated .

Default value

cognos_admin

Authentication datasource name

Description

Specifies the name of the data source for the reporting system user that holds the Cognos login credentials.

Default value

Cognos

Enable form authentication

Description

Specifies whether form-based authentication is enabled. You set this property to True when either of the following condition is true:

  • When the Unica is not installed in the same domain as the IBM® Cognos applications.
  • When IBM Cognos is accessed by using an IP address (within the same network domain) instead of the Fully Qualified Hostname (which is being used to access the Unica applications), even if both the Unica applications and the IBM Cognos installation are on the same machine.

However, when the value is True, the login process to Cognos Connection passes the login name and password in clear text and therefore is not secure unless IBM Cognos and the Unica are configured to use SSL communication.

Even with SSL configured, the user name and password appear as clear text in the HTML source code when you "view source" in a displayed report. For this reason, you must install IBM Cognos and Unica in the same domain.

Default value

False

Valid Values

True | False