Reports | Integrations | Cognos® [version]
The IBM® EMM suite integrates with IBM® Cognos® to generate reports.
This page displays properties that specify URLs and other parameters that are used by the IBM® 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 IBM® 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 IBM® 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 IBM® Authentication Provider.
Default value
Unica
Authentication user name
Description
Specifies the login name for the reporting system user. The IBM® 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 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 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