HCL Marketing Platform v10.0 documentation
Welcome to the HCL Marketing Platform v10.0 documentation, where you can find information about how to administer and use Marketing Platform.
Read Me First
Read this document before you start installing, configuring, or using HCL® Marketing Platform .
HCL Marketing Platform features
HCL Marketing Platform provides security, configuration, notification, and dashboard features for HCL® Marketing Software products.
HCL® Marketing Software user account management
You can manage the attributes of user accounts created using HCL® Marketing Platform user interface, which we refer to as internal accounts. This is in contrast to external user accounts, which are imported from an external system such as an LDAP server or web access control system.
Security management
HCL® Marketing Platform supports roles and permissions to control user access to objects and features in HCL® Marketing Software applications.
Configuration management
When HCL® Marketing Software is first installed, the Configuration page shows only the properties used to configure HCL® Marketing Platform and some global configuration properties. When you install additional HCL Marketing Software applications, the properties used to configure these applications are registered with Marketing Platform. These properties are then shown on the Configuration page, where you can set or modify their values.
Dashboard management
Dashboards are configurable pages that contain information useful to groups of users who fill various roles within your company. The components that make up dashboards are called portlets. Dashboards can contain pre-defined portlets or portlets that you create.
The HCL® Marketing Software Scheduler
The HCL® Marketing Software Scheduler enables you to configure a process to run at intervals that you define.
SAML 2.0 based federated authentication
HCL® Marketing Platform implements a SAML 2.0 based Identity Provider (IdP) that enables a single sign-on federation among HCL® Marketing Software products or between HCL Marketing Software products and third party applications.
SAML 2.0 single sign-on
Marketing Platform supports SAML 2.0 based single sign-on.
Configuring JWT authentication between applications
JSON web token (JWT) authentication is used for Journey Designer+Campaign. JWT authentication allows single sign-on between applications.
Single sign-on between HCL® Marketing Software and IBM® Digital Analytics
If your organization uses IBM® Digital Analytics, you can enable single sign-on between Digital Analytics and HCL Marketing Software.
Integration between HCL® Marketing Software and Windows™ Active Directory
Marketing Platform can be configured to integrate with Windows™ Active Directory server or another LDAP (Lightweight Directory Access Protocol) server. By integrating HCL® Marketing Software with a directory server, you can maintain users and groups in one centralized location. Integration provides a flexible model for extending the enterprise authorization policies into HCL Marketing Software applications. Integration reduces support costs and the time needed to deploy an application in production.
Integration between HCL® Marketing Software and LDAP servers
Marketing Platform can be configured to integrate with Windows™ Active Directory server or another LDAP (Lightweight Directory Access Protocol) server. By integrating HCL® Marketing Software with a directory server, you can maintain users and groups in one centralized location. Integration provides a flexible model for extending the enterprise authorization policies into HCL Marketing Software applications. Integration reduces support costs and the time needed to deploy an application in production.
Integration with web access control platforms
Organizations use web access control platforms to consolidate their security systems, which provide a portal that regulates user access to web sites. This section provides an overview of HCL® Marketing Software integration with web access control platforms.
Alert and notification management
HCL® Marketing Platform provides support for system alerts and user notifications sent by HCL® Marketing Software products.
Implementation of one-way SSL
This section describes one-way SSL in HCL® Marketing Software.
Security framework for HCL® Marketing Software APIs
Marketing Platform provides the security framework for the APIs implemented by HCL® Marketing Software products.
Data filter creation and management
Data filters make it possible to restrict the customer data that an HCL® Marketing Software user can view and work with in HCL Marketing Software applications. You can think of the data you secure with a data filter as a data set defined by the fields in your customer tables that you specify.
Audit event tracking in HCL® Marketing Software
You can configure which audit events are tracked and assign a severity level to each tracked event.
The Marketing Platform system log
You should check the system log first if the Marketing Platform application malfunctions. The system log is independent of the security audit information, which is stored in the system tables. While the system log tracks some of the same information contained in the security audit reports, it also contains information useful in troubleshooting Marketing Platform.
Marketing Platform utilities
This section provides an overview of the Marketing Platform utilities, including some details that apply to all of the utilities and which are not included in the individual utility descriptions.
HCL® Marketing Software configuration properties
This section describes the configuration properties found on the Settings & Configuration page.
Customization of stylesheets and images in the HCL® Marketing Software user interface
You can customize the appearance of the user interface where most HCL® Marketing Software product pages appear. By editing a cascading style sheet and providing your own graphics, you can change many of the images, fonts, and colors in the user interface.
Adding internal user accounts
Use this procedure to add internal user accounts.
Deleting internal user accounts
Use this procedure to delete internal user accounts.
Changing internal user password expiration dates
Use this procedure to change password expiration dates for internal users.
Resetting internal user passwords
Use this procedure to reset internal user passwords.
Adding internal user data sources
Use this procedure to add data sources for internal users.
Changing internal user data sources
Use this procedure to change data source passwords or login names.
Changing internal user account properties
Use this procedure to change the properties of internal user account.
Changing internal user system status
Use this procedure to change the system status of internal users.
Adding internal user data sources
Use this procedure to add data sources for internal users.
Deleting internal user data sources
Use this procedure to delete internal user data sources.
The user management pages
Refer to this table if you need help completing the fields on the Users page.
Changing internal user account properties
Use this procedure to change the properties of internal user account.
Resetting internal user passwords
Use this procedure to reset internal user passwords.
Changing internal user account properties
Use this procedure to change the properties of internal user account.
Changing internal user data sources
Use this procedure to change data source passwords or login names.
Locale preference
You can set the locale for both internal and external users. This setting affects the display of language, time, numbers, and dates in HCL® Marketing Software applications.
The default user locale preference
Marketing Platform contains a default locale attribute that applies to all HCL® Marketing Software applications that implement it.
restoreAccess
The restoreAccess utility allows you to restore access to Marketing Platform if all users with PlatformAdminRole privileges have been inadvertently locked out or if all ability to log in to the Marketing Platform has been lost.
Cross-partition administration privileges
In a multi-partition environment, at least one user account with the PlatformAdminRole role in Marketing Platform is required, to enable you to administer security for HCL® Marketing Software users across all partitions.
Types of groups: internal and external
When HCL® Marketing Software is integrated with an external server (such as a supported LDAP server or a web access control system), it supports two types of groups: internal and external.
Partitions and security management
Partitions in Campaign and related products provide a way to secure the data associated with different groups of users. With partitioning, a user's partition appears as if it were a separate running instance of Campaign, with no indication that other partitions are running on the same system. This section describes special security management considerations in a multi-partition environment.
Pre-configured users and roles
When HCL® Marketing Software is first installed, three users are pre-configured and are assigned system-defined roles in Marketing Platform and Campaign, as described in this section.
Cross-partition administration privileges
In a multi-partition environment, at least one user account with the PlatformAdminRole role in Marketing Platform is required, to enable you to administer security for HCL® Marketing Software users across all partitions.
Overview of managing user application access in Marketing Platform
Using Marketing Platform security administration features to manage user application access is a multi-step process. The following procedure provides an overview of the basic process, which is described in detail in the remainder of this guide.
Adding an internal group
Use this procedure to add an internal group.
Adding a subgroup
Use this procedure to add an internal subgroup.
Deleting a group or subgroup
Remember, when you delete a group or subgroup, members of the group lose the roles assigned to that group, and any parents of that group also lose those role assignments, unless the roles are also explicitly assigned to the parents.
Assigning a group to a partition
This procedure is necessary only if multiple partitions are configured for Campaign. Only an account with the PlatformAdminRole role, such as the platform_admin user, can perform this task.
Adding a user to a group or subgroup
Use this procedure to add a user to a group or subgroup.
Removing a user from a group or subgroup
Use this procedure to remove a user from a group or subgroup.
Changing a group or subgroup description
Use this procedure to change a group or subgroup description.
The user group management pages
These are the fields you use to configure user groups.
Creating a role
You should create new roles only for products that have detailed permissions. The reporting function and some HCL® Marketing Software products have only basic permissions available, so there is no need to create additional roles for these products.
Modifying role permissions
Use this procedure to modify role permissions.
Removing a role from the system
Use this procedure to remove a role from HCL® Marketing Software.
Assigning a role to or removing a role from a group
If you add a role to a group or remove a role from a group, members of that group acquire or lose that role.
Assigning a role to or removing a role from a user
Use the Edit roles window to assign a role to or to remove a role from a user.
Definitions of permission states
For each role, you can specify which permissions are granted, not granted, or denied. You set these permissions on the Settings > User roles and permissions page.
Permissions for products that use only basic roles
The following table describes the functional definitions of the roles available for the HCL® Marketing Software products that use only the basic roles. See the product documentation for additional information.
Permissions for Marketing Platform
The following table describes the permissions you can assign to roles in Marketing Platform.
Permissions for Opportunity Detect
The following table describes permissions that you can assign to roles in Opportunity Detect.
HCL® Marketing Software configuration properties
This section describes the configuration properties found on the Settings & Configuration page.
Configuration management
When HCL® Marketing Software is first installed, the Configuration page shows only the properties used to configure HCL® Marketing Platform and some global configuration properties. When you install additional HCL Marketing Software applications, the properties used to configure these applications are registered with Marketing Platform. These properties are then shown on the Configuration page, where you can set or modify their values.
Templates for duplicating categories
The properties for an HCL® Marketing Software application are registered with Marketing Platform when the application is installed. When an application requires users to create duplicate categories for configuration purposes, a category template is provided.
Creating a category from a template
Use this procedure to create a category from a template on the Configuration page.
Navigating to a category
Use this procedure to navigate to a category on the Configuration page.
Editing property values
Use this procedure to modify a property value on the Configuration page.
Templates for duplicating categories
The properties for an HCL® Marketing Software application are registered with Marketing Platform when the application is installed. When an application requires users to create duplicate categories for configuration purposes, a category template is provided.
Assigning or changing a dashboard administrator
Use this procedure to assign or change a dashboard administrator.
The dashboard administrator
If you have been designated a dashboard administrator, you are responsible for managing the membership, layout, and content of that dashboard. This section describes how to manage dashboard membership.
Pre-defined portlets
HCL® Marketing Software provides two types of pre-defined dashboard portlets, which you can enable and then add to any dashboard you create.
Custom portlet types and availability
You can create portlets from the following types of HCL® Marketing Software pages.
Adding a pre-defined portlet to a dashboard
Use this procedure to add a pre-defined portlet to a dashboard.
Adding a custom portlet to a dashboard
Perform this procedure to add a custom portlet to a dashboard.
Scheduling a dashboard report
To schedule a dashboard report (either a pre-defined or user-created portlet), you must first create a view and schedule it, and then configure the portlet as described here.
Adding a pre-defined portlet to a dashboard
Use this procedure to add a pre-defined portlet to a dashboard.
Custom portlet types and availability
You can create portlets from the following types of HCL® Marketing Software pages.
Dashboards and partitions
If you are administering dashboards in a multi-partition environment, read this section to understand how multiple partitions affect dashboards.
Partitions and security management
Partitions in Campaign and related products provide a way to secure the data associated with different groups of users. With partitioning, a user's partition appears as if it were a separate running instance of Campaign, with no indication that other partitions are running on the same system. This section describes special security management considerations in a multi-partition environment.
Dashboard management
Dashboards are configurable pages that contain information useful to groups of users who fill various roles within your company. The components that make up dashboards are called portlets. Dashboards can contain pre-defined portlets or portlets that you create.
Custom portlets
Topics in this section describe how to create and use custom portlets.
Enabling or disabling pre-defined portlets
Perform this task before you begin to create dashboards. You should enable only those portlets that reference HCL® Marketing Software products that you have installed.
Creating a pre-assembled dashboard
Use this procedure to create a pre-assembled dashboard.
Single sign-on between HCL® Marketing Software and IBM® Digital Analytics
If your organization uses IBM® Digital Analytics, you can enable single sign-on between Digital Analytics and HCL Marketing Software.
Implementation of one-way SSL
This section describes one-way SSL in HCL® Marketing Software.
Preparing the URL from a Digital Analytics report
Use this procedure for Digital Analytics reports.
The Create Custom Portlet page
Refer to this table if you need help completing the fields on the Custom Portlet page.
Adding a custom portlet to a dashboard
Perform this procedure to add a custom portlet to a dashboard.
Dynamic tokens
When you define a custom dashboard portlet, you can use pre-defined tokens that are replaced with the values stored in Marketing Platform for the current user when the portlet is invoked.
The dashboard administrator
If you have been designated a dashboard administrator, you are responsible for managing the membership, layout, and content of that dashboard. This section describes how to manage dashboard membership.
Granting or removing dashboard membership
Use this procedure to grant or remove dashboard membership.
Enabling or disabling pre-defined portlets
Perform this task before you begin to create dashboards. You should enable only those portlets that reference HCL® Marketing Software products that you have installed.
Adding a pre-defined portlet to a dashboard
Use this procedure to add a pre-defined portlet to a dashboard.
The Manage Portlets page
Refer to this table if you need help completing the fields in the Manage Portlets page.
Dashboards and partitions
If you are administering dashboards in a multi-partition environment, read this section to understand how multiple partitions affect dashboards.
Adding a pre-defined portlet to a dashboard
Use this procedure to add a pre-defined portlet to a dashboard.
Enabling or disabling pre-defined portlets
Perform this task before you begin to create dashboards. You should enable only those portlets that reference HCL® Marketing Software products that you have installed.
Creating a dashboard that is not pre-assembled
Use this procedure to create a dashboard that is not pre-assembled
Creating a pre-assembled dashboard
Use this procedure to create a pre-assembled dashboard.
Overview of working with dashboards in a multi-partition environment
When you have multiple partitions configured, follow these guidelines when you set up dashboards.
Quick link portlets
Quick links are pre-defined links to HCL® Marketing Software products. Some quick links enable users to perform basic actions in the HCL Marketing Software product within the dashboard, without navigating to the product. You can configure portlets that contain a set of quick links that you choose.
Creating a quick link portlet
Use this procedure create a quick link portlet.
The Create Custom Portlet page
Refer to this table if you need help completing the fields on the Custom Portlet page.
Adding a custom portlet to a dashboard
Perform this procedure to add a custom portlet to a dashboard.
Preparing the URL from a Digital Analytics for On Premises report
Use this procedure for reports in a Digital Analytics for On Premises installation.
Preparing the URL from an IBM® Cognos® dashboard report
The format of an IBM® Cognos® dashboard portlet URL is as follows.
Preparing the URL from a Digital Analytics report
Use this procedure for Digital Analytics reports.
Adding a custom portlet to a dashboard
Perform this procedure to add a custom portlet to a dashboard.
Overview of the portlet creation process
This section provides an overview of the steps for creating a portlet, which are described in detail elsewhere in this guide.
Scheduling a dashboard report
To schedule a dashboard report (either a pre-defined or user-created portlet), you must first create a view and schedule it, and then configure the portlet as described here.
Preparing the URL from an IBM® Cognos® dashboard report
The format of an IBM® Cognos® dashboard portlet URL is as follows.
Difference between the HCL® Campaign Schedule process and HCL® Marketing Software Scheduler
Starting with the 8.0 release of Marketing Platform, the HCL® Marketing Software Scheduler is intended to replace the Campaign Schedule process for scheduling runs of an entire flowchart. The HCL Marketing Software Scheduler is more efficient, as it does not consume any server system resources when the flowchart is not actually running.
The HCL® Marketing Software Scheduler
The HCL® Marketing Software Scheduler enables you to configure a process to run at intervals that you define.
Schedule triggers that are sent from an external script
The HCL® Marketing Software Scheduler can respond to triggers sent by an external application. The scheduler_console_client utility enables this feature. This utility issues triggers that can launch one or more schedules set up to listen for that trigger.
scheduler_console_client
Jobs configured in the HCL® Marketing Software Scheduler can be listed and kicked off by this utility, if they are set up to listen for a trigger.
Scheduler throttling
Throttling is used to manage performance when a large number of processes are likely to place high demands on the system. Throttling is based on scheduler groups that you set up on the Settings > Configuration page. You assign a throttling threshold to a group, and associate schedules with that group.
Setting up throttling for the HCL® Marketing Software Scheduler
You must set up a throttling group for each type of object being scheduled.
Whitelist prerequisite for external tasks (with FixPack 10.0.0.1 only)
Only if you have applied Marketing Platform FixPack 10.0.0.1, a whitelist prerequisite applies to any external tasks that you create to schedule API calls or scripts.
Adding an API to the whitelist
Only if you have applied Marketing Platform FixPack 10.0.0.1, perform this procedure before you create any external tasks that schedule an API call.
Adding a script to the whitelist
Only if you have applied Marketing Platform FixPack 10.0.0.1, perform this procedure before you create any external tasks that schedule a script.
The create a schedule wizard
This section describes in detail the pages you use when you create a schedule.
Adding an API to the whitelist
Only if you have applied Marketing Platform FixPack 10.0.0.1, perform this procedure before you create any external tasks that schedule an API call.
Adding a script to the whitelist
Only if you have applied Marketing Platform FixPack 10.0.0.1, perform this procedure before you create any external tasks that schedule a script.
Whitelist prerequisite for external tasks (with FixPack 10.0.0.1 only)
Only if you have applied Marketing Platform FixPack 10.0.0.1, a whitelist prerequisite applies to any external tasks that you create to schedule API calls or scripts.
Time zone support
You can schedule runs to occur in the context of any one of a large number of worldwide time zones.
Schedules that depend on completion of multiple runs
You can configure a schedule to run only when multiple other schedules have finished their runs by using the On completion of other tasks option in the When to start drop down list.
The create a schedule wizard
This section describes in detail the pages you use when you create a schedule.
The create a schedule wizard
This section describes in detail the pages you use when you create a schedule.
The Schedule management pages
You access the scheduler management pages by selecting Settings > Schedule Management or by selecting View when scheduled from a flowchart's Run menu.
Schedule management
You can manage all schedules from the Settings > Schedule management page. You must have the Administer Scheduled tasks page permission in Marketing Platform to manage schedules.
The Schedule management pages
You access the scheduler management pages by selecting Settings > Schedule Management or by selecting View when scheduled from a flowchart's Run menu.
scheduler_console_client
Jobs configured in the HCL® Marketing Software Scheduler can be listed and kicked off by this utility, if they are set up to listen for a trigger.
Schedule triggers that are sent from an external script
The HCL® Marketing Software Scheduler can respond to triggers sent by an external application. The scheduler_console_client utility enables this feature. This utility issues triggers that can launch one or more schedules set up to listen for that trigger.
Creating a category from a template
Use this procedure to create a category from a template on the Configuration page.
Setting up throttling for the HCL® Marketing Software Scheduler
You must set up a throttling group for each type of object being scheduled.
SAML 2.0 single sign-on
Marketing Platform supports SAML 2.0 based single sign-on.
Setting SAML 2.0 configuration properties
To configure SAML 2.0 single sign-on, set properties on the Configuration > Settings page.
HCL® Marketing Platform | Security | Login method details | SAML 2.0
Properties in this category configure single sign-on through a SAML 2.0 IdP server.
Setting configuration properties on the Configuration page
Set configuration properties on the Settings > Configuration page to configure federated authentication in HCL® Marketing Software.
HCL® Marketing Platform | Security | Federated authentication
The properties in this category are used in implementing SAML (Security Assertion Markup Language) 2.0 based federated authentication, which enables single sign-on among diverse applications.
HCL® Marketing Platform | Security | Federated authentication | partitions | partition[n]
The properties in this category are used in implementing SAML (Security Assertion Markup Language) 2.0 based federated authentication between HCL® Marketing Software applications and other HCL® and third party applications.
Configuring JWT authentication between applications
JSON web token (JWT) authentication is used for Journey Designer+Campaign. JWT authentication allows single sign-on between applications.
IBM® Marketing Platform | Security | JWT authentication
JWT authentication is used for Journey Designer+Campaign. JWT authentication allows single sign-on between applications.
Setting up single sign-on between HCL® Marketing Software and Digital Analytics using automatic user account creation
Use this procedure to set up single sign-on between HCL® Marketing Software and Digital Analytics using automatic user account creation.
Configuring WebLogic for single sign-on between Digital Analytics and HCL® Marketing Software
Perform the procedure below in the WebLogic domain where Marketing Platform is deployed to ensure that users can view Digital Analytics reports in dashboards without having to log in.
Configuring WebSphere® for single sign-on between Digital Analytics and HCL® Marketing Software
Perform the procedure below in WebSphere® cell and node where Marketing Platform is deployed to ensure that users can view Digital Analytics reports in dashboards without having to log in.
Setting up single sign-on between HCL® Marketing Software and Digital Analytics using manual user account creation
Use this procedure to set up single sign-on between HCL® Marketing Software and Digital Analytics using manual user account creation.
Configuring WebLogic for single sign-on between Digital Analytics and HCL® Marketing Software
Perform the procedure below in the WebLogic domain where Marketing Platform is deployed to ensure that users can view Digital Analytics reports in dashboards without having to log in.
Configuring WebSphere® for single sign-on between Digital Analytics and HCL® Marketing Software
Perform the procedure below in WebSphere® cell and node where Marketing Platform is deployed to ensure that users can view Digital Analytics reports in dashboards without having to log in.
Next steps
After you install the custom proxy server and import the Digital Analytics certificate, your next steps are to enable single sign-on and configure integration between Digital Analytics and Campaign.
Campaign | partitions | partition[n] | Coremetrics
The properties in this category specify integration settings for Digital Analytics and Campaign for the selected partition.
Setting up single sign-on between HCL® Marketing Software and Digital Analytics using automatic user account creation
Use this procedure to set up single sign-on between HCL® Marketing Software and Digital Analytics using automatic user account creation.
Setting up single sign-on between HCL® Marketing Software and Digital Analytics using manual user account creation
Use this procedure to set up single sign-on between HCL® Marketing Software and Digital Analytics using manual user account creation.
Digital Analytics configuration properties
This section describes the Digital Analytics configuration properties on the Configuration page.
About Distinguished Names
To enable directory server integration in HCL® Marketing Software, you must determine the Distinguished Name (DN) for a user and for groups. The DN of an object on the directory server is the complete path through the directory server tree structure to that object.
Obtaining required information
Obtain the required information about the directory server with which you want to integrate. You use this information during the configuration process, to store directory server credentials and to set configuration property values.
Configuration process roadmap: Active Directory integration
Use this configuration process roadmap to scan the tasks required to integrate HCL® Marketing Software with Windows™ Active Directory. The Topic column provides links to the topics that describe the tasks in detail.
The user management pages
Refer to this table if you need help completing the fields on the Users page.
Forcing synchronization of external users
Use this procedure to force synchronization of users when HCL® Marketing Software is integrated with an LDAP server or web access control system.
Active Directory integration features
Marketing Platform integration with Windows™ Active Directory provides the features described in this section.
Configuration process roadmap: LDAP integration
Use this configuration process roadmap to scan the tasks required to integrate HCL® Marketing Software with LDAP. The Topic column provides links to the topics that describe the tasks in detail.
The user management pages
Refer to this table if you need help completing the fields on the Users page.
Forcing synchronization of external users
Use this procedure to force synchronization of users when HCL® Marketing Software is integrated with an LDAP server or web access control system.
LDAP integration features
Marketing Platform integration with LDAP provides the features described in this section.
Adding internal user data sources
Use this procedure to add data sources for internal users.
Storing directory server credentials in Marketing Platform
If your directory server does not allow anonymous access, you must configure an HCL® Marketing Software user account to hold the user name and password of a directory server user, as described in the following procedure.
HCL® Marketing Platform | Security | Login method details | LDAP
Properties in this category are used to configure LDAP integration.
Setting LDAP login method connection properties in HCL® Marketing Software
LDAP login method properties specify connection details the system uses to connect to the directory server.
HCL® Marketing Platform | Security | LDAP synchronization
LDAP synchronization properties specify details that the system uses to log into the directory server and identify users to import. Some of these properties also control the frequency and other details of the automatic synchronization process.
Setting LDAP synchronization properties
LDAP synchronization properties specify details that the system uses to log into the directory server and identify users to import. Some of these properties also control the frequency and other details of the automatic synchronization process.
HCL® Marketing Platform | Security | LDAP synchronization
LDAP synchronization properties specify details that the system uses to log into the directory server and identify users to import. Some of these properties also control the frequency and other details of the automatic synchronization process.
Setting user attributes map properties
These properties specify the user attributes that the system imports from the directory server.
HCL® Marketing Platform | Security | LDAP synchronization | LDAP reference to HCL® Marketing Platform group map
Properties in this category are used to configure LDAP integration.
Mapping LDAP groups to HCL® Marketing Software groups
Users who belong to the directory server groups you map here are imported and made members of the Marketing Platform group or groups specified here.
Adding an internal group
Use this procedure to add an internal group.
Assigning a role to or removing a role from a group
If you add a role to a group or remove a role from a group, members of that group acquire or lose that role.
Adding a user to a group or subgroup
Use this procedure to add a user to a group or subgroup.
Setting up an Active Directory user with PlatformAdminRole permissions
When NTLMv2 authentication is enabled, you can not log in to HCL® Marketing Software as platform_admin, so you must perform the following procedure in order to have administrator access to Marketing Platform.
HCL® Marketing Platform | Security | Login method details | Web access control
Properties in this category are used to configure integration with web access control software.
Setting the security mode to enable NTLMv2 authentication
Only if you want to enable NTLMv2 authentication, set configuration properties as described in this procedure.
HCL® Marketing Platform | Security | Login method details | Web access control
Properties in this category are used to configure integration with web access control software.
HCL® Marketing Software | General | Navigation
Properties in this category specify values that are used internally to navigate among HCL® Marketing Software products.
Setting web access control connection properties in HCL® Marketing Software
To configure web access control integration, you set some configuration properties.
Implementation of one-way SSL
This section describes one-way SSL in HCL® Marketing Software.
Configuring integration with an SSL type of WebSEAL junction
Follow this procedure to configure Marketing Platform integration with IBM Security Access Manager using an SSL type of WebSEAL junction.
Configuring SiteMinder for HCL® Marketing Software products
Unprotect objects in SiteMinder as described in this procedure to enable correct functioning of your HCL® Marketing Software products.
Enabling single logouts with SiteMinder
To enable a logout of SiteMinder when a user logs out of an HCL® Marketing Software application, configure SiteMinder as follows.
Two ways to create data filters: automatic generation and manual specification
Marketing Platform provides a utility, datafilteringScriptTool, that processes XML to create the data filters in the Marketing Platform system tables. Depending on how you write the XML, you can use this utility in two ways: automatic generation and manual specification.
Example: Manually specifying data filters
Jim needs to create a set of data filters based on sales territories.
Example: Automatically generating a set of data filters
Jim needs to create a set of data filters based on countries, cities, and states.
datafilteringScriptTool
The datafilteringScriptTool utility reads an XML file to populate the data filtering tables in the Marketing Platform system table database.
ManagerSchema_PurgeDataFiltering.sql
The ManagerSchema_PurgeDataFiltering.sql script removes all data filtering data from the Marketing Platform system tables without removing the data filter tables themselves. This script removes all data filters, data filter configurations, audiences, and data filter assignments from Marketing Platform.
Populating the data filter system tables
Run the datafilteringScriptTool utility, which uses your XML to populate the data filter system tables.
Creating the XML to specify data filters
Create the XML file that specifies the customer data used as criteria in each data filter. In the next step you will run a utility that populates the system tables with these specifications.
Data filter XML reference
This section describes the XML elements for which you must provide values.
Example: Manually specifying data filters
Jim needs to create a set of data filters based on sales territories.
Example: Automatically generating a set of data filters
Jim needs to create a set of data filters based on countries, cities, and states.
Setting required data filter configuration properties
Set required configuration properties to enable data filtering.
Optional configuration property to improve data filter performance
You can turn the data filter cache on for better performance.
HCL® Marketing Software | General | Data filtering
Properties in this category specify values used when data filtering is implemented.
Two ways to assign users and groups: in the user interface and in the XML
You have two options for assigning users and groups to data filters: through the user interface or in the XML you use to create the data filters. Assigning users in the XML is a useful method when you have many users, each of whom requires a separate filter.
Assigning users and groups to data filters
If you do not assign users or groups within the XML that you create, use the HCL® Marketing Software data filter user interface to perform searches for users, groups, and data filters and then select items from the search results and assign them.
About assigning users and groups in the XML
You can assign users or groups to data filters in the XML, as an alternative to doing this through the user interface. Assigning users and groups to data filters in the XML is available only when you use manual specification to create the data filters.
About assigning user and groups though the user interface
You can assign users and groups to data filters on the Settings > Data filters pages.
Example: Automatically generating a set of data filters
Jim needs to create a set of data filters based on countries, cities, and states.
Example: Manually specifying data filters
Jim needs to create a set of data filters based on sales territories.
About assigning user and groups though the user interface
You can assign users and groups to data filters on the Settings > Data filters pages.
Optional configuration property to improve data filter performance
You can turn the data filter cache on for better performance.
HCL® Marketing Software | General | Data filtering
Properties in this category specify values used when data filtering is implemented.
Schedule notifications
You can set up notifications for any schedule, to alert you to the status of scheduled runs. In addition, users with Administrator permissions in Marketing Platform can set up groups to which notifications are sent.
Configuring email notifications in HCL® Marketing Software
Follow this procedure to configure the Marketing Platform to send system alert and notification emails to users. You must have an email server set up before you start.
Alert and notification management
HCL® Marketing Platform provides support for system alerts and user notifications sent by HCL® Marketing Software products.
HCL® Marketing Software | General | Communication | Email
Properties in this category are used to configure the Marketing Platform to send emails to users for system alerts and notifications.
HCL® Marketing Platform | Notifications
Properties in this category control system behavior for notifications that HCL® Marketing Software products can send to users.
Configuring email notifications in HCL® Marketing Software
Follow this procedure to configure the Marketing Platform to send system alert and notification emails to users. You must have an email server set up before you start.
Adding internal user data sources
Use this procedure to add data sources for internal users.
Configuring email notifications in HCL® Marketing Software
Follow this procedure to configure the Marketing Platform to send system alert and notification emails to users. You must have an email server set up before you start.
Configuring your web application servers for SSL
On every application server on which an HCL® Marketing Software application is deployed, configure the web application server to use the certificates you have decided to employ.
SSL in HCL® Marketing Software
Many HCL® application components can act as both server and client during normal operations, and some HCL components are written in Java™ and some in C++. These facts determine the format of the certificates you use. You specify the format when you create a self-signed certificate or purchase one from a CA.
Configuring SSL in Marketing Platform
Follow this procedure to configure SSL in Marketing Platform.
Configuring SSL in Marketing Platform with LDAP integration
Follow this procedure to configure SSL in Marketing Platform.
Configuring SSL in Marketing Platform with data filters
When Marketing Platform is deployed with SSL and you plan to use the data filtering feature, you must perform this procedure to add the SSL options that perform hand shaking.
Security framework for HCL® Marketing Software APIs
Marketing Platform provides the security framework for the APIs implemented by HCL® Marketing Software products.
HCL® Marketing Platform | Security | API management | [Product] | (API configuration template)
Use the templates in this category to configure authentication for HCL® Marketing Software APIs. You can block access, require HTTPS, or require authentication for APIs.
Security framework for HCL® Marketing Software APIs
Marketing Platform provides the security framework for the APIs implemented by HCL® Marketing Software products.
SAML 2.0 based federated authentication
HCL® Marketing Platform implements a SAML 2.0 based Identity Provider (IdP) that enables a single sign-on federation among HCL® Marketing Software products or between HCL Marketing Software products and third party applications.
Configuring which audit events appear in the report
To specify the audit events that are available in the audit report and their severity, you set properties on the Settings > Configuration page.
HCL® Marketing Platform | Audit Events
The property on this page determines whether audit events are tracked.
HCL® Marketing Platform | Audit Events | Audit events configuration
The events you select on this page are available in the security audit reports.
HCL® Marketing Platform | Audit Events | Audit events severity configuration
The severity level you specify for each event on this page appears in the Audit Events report. You can use the severity level to sort and filter the report data. The events are identical to those in the HCL Marketing Platform | Audit Events | Audit events configuration category.
Archived audit events
You can configure backups of audit events by setting the value of configuration properties in the HCL Marketing Platform | Audit Events | Audit Events Configuration category on the Settings > Configuration page.
HCL® Marketing Platform | Audit Events | Audit events configuration
The events you select on this page are available in the security audit reports.
Configuring audit backup notifications
To notify users of the status of audit event backup, make them members of a group that you specify in a configuration property.
Configuring which audit events appear in the report
To specify the audit events that are available in the audit report and their severity, you set properties on the Settings > Configuration page.
Adding a user to a group or subgroup
Use this procedure to add a user to a group or subgroup.
Modifying the audit report content and display
You can add and remove events and columns, rearrange and sort the columns, set the time span, specify which tracked events are shown in the report, and filter the information.
Fields in the Report Parameters window
Use the fields on the Report Parameters page to configure the way the audit report is displayed.
configTool
The properties and values on the Configuration page are stored in the Marketing Platform system tables. You can use the configTool utility to import and export configuration settings to and from the system tables.
Configuration management
The Configuration page provides access to the central configuration properties for HCL® Marketing Software applications.
Marketing Platform utilities
This section provides an overview of the Marketing Platform utilities, including some details that apply to all of the utilities and which are not included in the individual utility descriptions.
encryptPasswords
The encryptPasswords utility is used to encrypt and store either of two passwords that Marketing Platform uses internally.
partitionTool
Partitions are associated with Campaign policies and roles. These policies and roles and their partition associations are stored in the Marketing Platform system tables. The partitionTool utility seeds the Marketing Platform system tables with basic policy and role information for partitions.
populateDb
The populateDb utility inserts default (seed) data in the Marketing Platform system tables.
configTool
The properties and values on the Configuration page are stored in the Marketing Platform system tables. You can use the configTool utility to import and export configuration settings to and from the system tables.
ManagerSchema_DeleteAll.sql
The Manager_Schema_DeleteAll.sql script removes all data from the Marketing Platform system tables without removing the tables themselves. This script removes all users, groups, security credentials, data filters, and configuration settings from Marketing Platform.
SQL scripts for creating system tables
Use the scripts described in the following table to create Marketing Platform system tables manually, when your company policy does not allow you to use the installer to create them automatically.
populateDb
The populateDb utility inserts default (seed) data in the Marketing Platform system tables.
configTool
The properties and values on the Configuration page are stored in the Marketing Platform system tables. You can use the configTool utility to import and export configuration settings to and from the system tables.
ManagerSchema_DropAll.sql
The ManagerSchema_DropAll.sql script removes all Marketing Platform system tables from a database. This script removes all tables, users, groups, security credentials, and configuration settings from Marketing Platform.
Preparing your corporate theme
Follow these guidelines to create your corporate theme for the HCL® Marketing Software frameset.
Applying your corporate theme
Follow this procedure to apply your corporate theme to the HCL® Marketing Software user interface.
Use the installation roadmap to quickly find the information that you need for installing Marketing Platform.
Installation overview
An installation of Marketing Platform is complete when you install, configure, and deployinstall and configure Marketing Platform. The Marketing Platform Installation Guide provides detailed information about installing, configuring, and deployinginstalling and configuring Marketing Platform.
Planning the Platform Installation
When you plan your Marketing Platform and Attribution Modeler installation, you must ensure that you have set up your system correctly, and that you have configured your environment to deal with any failures.
Creating the Marketing Platform data sources
You must create Marketing Platform data sources before you can install Marketing Platform.
Installing CampaignDistributed MarketingeMessageContact OptimizationInteractLeadsOpportunity DetectionDigital Analytics for On PremisesCustomerInsightPredictiveInsightMarketing OperationsInteraction HistoryAttribution ModelerCampaign
You must run the HCL® Marketing Software installer to start the installation of Marketing Platform. The HCL Marketing Software installer starts the Marketing Platform installer during the installation process. Make sure that the HCL Marketing Software installer and the product installer are saved at the same location.
Deploying Marketing Platform
You must follow a set of guidelines when you deploy Marketing Platform in your web application server. There is a different set of guidelines for deploying Marketing Platform on WebLogic and on WebSphere®.
Configuring Marketing Platform after deployment
For a basic installation of Marketing Platform, you must configure Marketing Platform after deployment if you use the HCL® Marketing Software reporting feature, or if you want to use a password policy.
Marketing Platform supports an IBM WebSphere Application Server cluster deployment. Clustering is not supported on WebLogic.
This section provides an overview of the Marketing Platform utilities, including some details that apply to all of the utilities and which are not included in the individual utility descriptions.
About Marketing Platform SQL scripts
This section describes the SQL scripts provided with Marketing Platform to perform various tasks relating to the Marketing Platform system tables.
Uninstalling CampaignDistributed MarketingeMessageContact OptimizationInteractLeadsOpportunity DetectionDigital Analytics for On PremisesCustomerInsightPredictiveInsightMarketing OperationsInteraction HistoryAttribution Modeler
Run the Marketing Platform and Attribution Modeler uninstallers to uninstall Marketing Platform. When you run the Marketing Platform uninstaller, the files that were created during the installation process are removed. For example, files such as configuration files, installer registry information, and user data are removed from the computer.
You can upgrade your current version of Marketing Platform to bring it up-to-date with the latest features.
An upgrade of Marketing Platform is complete when you upgrade, configure, and deployupgrade and configure Marketing Platform. The Marketing Platform Upgrade Guide provides detailed information about upgrading, configuring, and deployingupgrading and configuring Marketing Platform.
Planning the CampaignDistributed MarketingeMessageContact OptimizationInteractLeadsOpportunity DetectionDigital Analytics for On PremisesCustomerInsightPredictiveInsightMarketing OperationsInteraction HistoryAttribution ModelerMarketing PlatformMarketing Platform upgrade
You can upgrade your current version of Marketing Platform to bring it up-to-date with the latest features.
Automatic migration allows the installer to run the SQL script and insert the configuration properties that are required to upgrade your Marketing Platform system tables. If your company policy does not allow automated updates to your system table database, you must use manual migration, described elsewhere in this guide.
The Marketing Platform upgrade installer can perform all of the data migration that is required for an upgrade automatically. However, if the policy of your organization does not allow automatic migration, you must complete the migration procedure to upgrade Marketing Platform manually.
The Marketing Platform upgrade installer can perform all of the data migration that is required for an upgrade automatically. However, if the policy of your organization does not allow automatic migration, you must complete the migration procedure to upgrade Marketing Platform manually.
The Marketing Platform upgrade installer can perform all of the data migration that is required for an upgrade automatically. However, if the policy of your organization does not allow automatic migration, you must complete the migration procedure to upgrade Marketing Platform manually.
The Marketing Platform upgrade installer can perform all of the data migration that is required for an upgrade automatically. However, if the policy of your organization does not allow automatic migration, you must complete the migration procedure to upgrade Marketing Platform manually.
The Marketing Platform upgrade installer can perform all of the data migration that is required for an upgrade automatically. However, if the policy of your organization does not allow automatic migration, you must complete the migration procedure to upgrade Marketing Platform manually.
You must follow a set of guidelines when you deploy Marketing Platform in your web application server. There is a different set of guidelines for deploying Marketing Platform on WebLogic and on WebSphere®.
Configuring Marketing Platform after deployment
For a basic installation of Marketing Platform, you must configure Marketing Platform after deployment if you use the HCL® Marketing Software reporting feature, or if you want to use a password policy.
This section provides an overview of the Marketing Platform utilities, including some details that apply to all of the utilities and which are not included in the individual utility descriptions.
About Marketing Platform SQL scripts
This section describes the SQL scripts provided with Marketing Platform to perform various tasks relating to the Marketing Platform system tables.
Uninstalling CampaignDistributed MarketingeMessageContact OptimizationInteractLeadsOpportunity DetectionDigital Analytics for On PremisesCustomerInsightPredictiveInsightMarketing OperationsInteraction HistoryAttribution Modeler
Run the Marketing Platform and Attribution Modeler uninstallers to uninstall Marketing Platform. When you run the Marketing Platform uninstaller, the files that were created during the installation process are removed. For example, files such as configuration files, installer registry information, and user data are removed from the computer.
Installation overview
An installation of the HCL® Marketing Software reports is complete when you install HCL® Cognos® BI and configure it for HCL Marketing Software applications. This guide provides detailed information about configuring HCL Cognos BI, and integrating HCL Cognos BI with HCL Marketing Software.
Plan the HCL® Marketing Software reports installation
When you plan your HCL® Marketing Software reports installation, you must ensure that you correctly set up your system and configure your environment.
Install reporting components
To install HCL® Marketing Software reporting for your products, you must install the reporting components.
Install and test IBM® Cognos® BI
Your license agreement with HCL® must grant you an HCL Cognos® BI license so you can download the HCL Cognos BI installation files. HCL Cognos BI is a collection of applications, servers, and services that is organized in a multi-tiered architecture.
Integration roadmap for HCL® Marketing Software and Cognos®
After you install HCL® Cognos®, you must integrate the HCL® Marketing Software suite with HCL Cognos.
How to configure reporting
After you install or upgrade your reporting packages, you must configure your reporting installation.
User authorization for Cognos folders and reports
A Custom Java Authentication Provider (CJAP) provides authorization for users who access Cognos report folders and reports. You can implement this feature after you implement the HCL® Marketing Software Authentication Provider, which provides single sign-on authentication between HCL Marketing Software applications and Cognos.
How to configure the HCL® Cognos® Reports for multiple partitions
If you use Campaign, eMessage, or Interact with more than one partition, you must configure the HCL® Cognos® reports packages for each partition. You can set up reporting on multiple partitions after you configure the partitions in Campaign and eMessage.
How to upgrade reports
You can upgrade your current version of HCL® Marketing Software reports to bring it up-to-date with the latest features.
Upgrading the 8.x or 9.x model and installing new reports
Upgrading the 8.x or 9.x model and installing the new reports are the first steps that you must complete to upgrade your reports.
Report configuration properties
The report configuration properties for HCL® Marketing Software are at Settings > Configuration > Reports.
Formats for the Cognos® reports
The HCL® Cognos® reporting integration components include a global report style sheet, GlobalReportStyles.css.
Formats for the Campaign, eMessage, and Interact Cognos reports
Additional styling is required for Campaign, eMessage, and Interact Cognos reports. The global report styles are modified to add classes to override the styling of existing classes to improve the look and feel of Campaign, eMessage, and Interact reports.
Campaign reports and reporting schemas
You can customize the reporting schemas in the Campaign Report Package by adding contact or response metrics, attributes, or response types.
HCL Marketing Platform provides security, configuration, notification, and dashboard features for HCL® Marketing Software products.