Reports | Integrations | Cognos [version]

The HCL® Marketing Software suite integrates with HCL® Cognos to generate reports.

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

Integration Name

Description

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

Default value

Cognos

Vendor

Description

Read-only. Specifies that HCL 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 HCL 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 HCL 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 HCL 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 HCL 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 HCL Cognos application is using the HCL Authentication Provider, which means it relies on the Marketing Platform for authentication.

Default value

anonymous

Valid Values
  • anonymous: means that authentication is disabled.
  • authenticated: means that the communications between the HCL 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 HCL Authentication Provider.

Default value

UNICA

Authentication user name

Description

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

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 HCL Marketing Software is not installed in the same domain as the HCLCognos applications.
  • When HCL Cognosis accessed by using an IP address (within the same network domain) instead of the Fully Qualified Hostname (which is being used to access the HCL Marketing Software applications), even if both the HCL Marketing Software applications and the HCL 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 HCL Cognos and the HCL Marketing Software 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 HCL Cognos and HCL Marketing Software in the same domain.

Default value

False

Valid Values

True | False