Reports | Integrations | Cognos [version]
The IBM® EMM 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 IBM Cognos is the third-party reporting or analytical tool that is used by the IBM EMM 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 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 IBM EMM.
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 IBM EMM is not installed in the same domain as the IBMCognos applications.
- When IBM 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 IBM EMM applications), even if both the IBM EMM 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 IBM EMM 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 IBM EMM in the same domain.
- Default value
-
False
- Valid Values
-
True | False