Content Integration offers the following
out-of-the-box integrations: Adobe Experience Manager (AEM), HCL WCM, HCL Digital Experience
(DX) 95_CF205, HCL Commerce & Microsoft Azure (for cognitive services).
About this task
To configure Adobe Experience Manager (AEM), HCL WCM, HCL DX, HCL Commerce &
Microsoft Azure, complete the following steps:
Procedure
-
Setting up Adobe Experience Manager
-
Select .
The Configuration page
appears.
-
From the Configuration categories panel, expand .
The Create category from template for the
Adobe Experience Manager appears.
-
Provide values for the following fields and click Save
changes:
- New category name - Specify an
appropriate name to identify the new CMS. For example,
AEM.
- System Identifier -
AEM.
- User credentials
- defaultUserCredentials
- Data source name for credentials
- Anonymous Content Access - When this
field is set to No, then under CMS
configuration, the content preview will not show the download
icon. When set to Yes, it will show the
download icon.
For more information about the fields, see Configuring a third-party CMS for integration with Unica Content Integration.
-
In the Configuration properties pane, expand
AEM and select HTTP
Gateway.
The Settings for 'HTTP Gateway' page
appears.
-
Select Edit settings.
The (HTTP Gateway) Edit Settings page
appears.
-
For the AEM Base URL field, see Configuring a third-party CMS for integration with Unica Content Integration.
-
Click Save changes.
-
In the Configuration properties pane, expand
HTTP Gateway and select
REST.
The Settings for 'REST' page
appears.
-
Select Edit settings.
The (REST) Edit Settings page
appears.
-
For the Authentication Type field, select the
value Basic. If your AEM instance is set up to
use a different authentication method, use a different value. For more
information about the available values, see Configuring a third-party CMS for integration with Unica Content Integration.
-
Click Save changes.
-
In the Configuration properties pane, expand
QOS and select Retry
Policy.
The Settings for 'Retry Policy' page
appears.
-
Select Edit settings.
The (Retry Policy) Edit Settings page
appears.
-
For the Retry policy configurations, see Configuring a third-party CMS for integration with Unica Content Integration.
-
Click Save changes.
-
Publish status filter for Adobe Experience Manager
Note: If you plan to upgrade Unica Content Integration, ensure that you create
custom-plugin-services.yml, and store the
customized configurations. After update two files will be created:
- plugin-services.yml (for out of the box plugins)
- custom-plugin-services.yml (for custom plugins)
Installer will never overwrite custom-plugin-services.yml file since it will
contain the service declarations for custom plugins as well as customization for
out of the box services.
-
In the plugin-services.yml file, available under
<ASSET_PICKER_HOME>/conf directory, there
exists a configuration for AEM under "systems" section. Under "AEM", the
contentFilters
configuration parameter contains a
child parameter named publishStatus
. This parameter
filters search items by their published status. The parameter accepts
only one of the following values: Published or
Unpublished. Provide the required
value.
-
If you do not provide a value or if you provide an incorrect value, AEM
returns matching content, irrespective of its published status. This is
the default behavior because the
publishStatus
parameter, by default, is commented out.
-
Setting up WCM
-
Select .
The Configuration page
appears.
-
From the Configuration categories panel, expand .
The Create category from template for the
WCM appears.
-
Provide values for the following fields and click Save
changes:
-
In the Configuration properties pane, expand
WCM and select HTTP
Gateway.
The Settings for 'HTTP Gateway' page
appears.
-
Select Edit settings.
The (HTTP Gateway) Edit Settings page
appears.
-
For the WCM Base URL field, see Configuring a third-party CMS for integration with Unica Content Integration.
-
Click Save changes.
-
In the Configuration properties pane, expand
HTTP Gateway and select
REST.
The Settings for 'REST' page
appears.
-
Select Edit settings.
The (REST) Edit Settings page
appears.
-
For the Authentication Type field, select the
value Basic. If your WCM instance is set up to
use a different authentication method, use a different value. For more
information about the available values, see Configuring a third-party CMS for integration with Unica Content Integration.
-
Click Save changes.
-
In the Configuration properties pane, expand
QOS and select Retry
Policy.
The Settings for 'Retry Policy' page
appears.
-
Select Edit settings.
The (Retry Policy) Edit Settings page
appears.
-
For the Retry policy configurations, see Configuring a third-party CMS for integration with Unica Content Integration.
-
Click Save changes.
-
Publish status filter for WCM
Note: If you plan to upgrade Unica Content Integration, ensure that you back up
the file plugin-services.yml, if you have customized
the files. The installer overwrites the file and your customizations will be
lost.
-
In the plugin-services.yml file, available under
<ASSET_PICKER_HOME>/conf directory, there
exists a configuration for WCM under
systems
section.
Under WCM, the contentFilters
configuration parameter
contains a child parameter named publishStatus
. This
parameter filters search items by their published status. The parameter
accepts only one of the following values: DRAFT,
PUBLISHED, or EXPIRED.
Provide the required value.
-
If you do not provide a value or if you provide an incorrect value, WCM
returns matching content, irrespective of its published status. This is
the default behavior because the
publishStatus
parameter, by default, is commented out.
-
If you activate the
publishStatus
parameter or modify
its value, an application restart is mandatory.
-
Setting up HCL Digital Experience (DX-CORE)
-
Select .
The Configuration page
appears.
-
From the Configuration categories panel, expand .
The Create category from template for the
HCL Digital Experience (DX)
appears.
-
Provide values for the following fields and click Save
changes:
- New category name - Specify an
appropriate name to identify the new CMS. For example,
HCL - DX.
- System Identifier -
DX-CORE.
- User credentials - Default user
- defaultUserCredentials - asm_admin
- Data source name for credentials -
DX_NEW_DS
- Anonymous Content Access - Set this to
Yes.
- Additional Parameters - async: true
numberOfThreads: 4 dxMediaSystemIdentifier: DX
For more information about the fields, see Configuring a third-party CMS for integration with Unica Content Integration.
-
Click Save changes.
-
Ensure that the Data source name for credentials
field is blank.
-
In the Configuration properties pane, expand
HCL - DX and select HTTP
Gateway.
The Settings for 'HTTP Gateway' page
appears.
-
Select Edit settings.
The (HTTP Gateway) Edit Settings page
appears.
-
Provide a value for the Base URL field. If
required, the Base URL can also be used for
authenticating the HCL DX - Media Library
credentials. See Step 6 for configuring
HCL DX - Media
Library
. Click Save changes.
-
In the Configuration properties pane, expand
HTTP Gateway and select
REST.
The Settings for 'REST' page
appears.
-
Select Edit Settings.
- Base URL -
http://<dx_host>:<dx_port>/dx
, where <dx_host>:<dx_port> is the host name and port number on which DX is configured.
- contentBaseUrl -
http://<dx_host>:<dx_port>
,
where <dx_host>:<dx_port> is the host
name and port number on which DX is configured.
- bypassProxy - No
-
For the Authentication Type field, select the
value None. If the HCL -
DX instance is set up to use a different authentication
method, use a different value. For more information about the available
values, see Configuring a third-party CMS for integration with Unica Content Integration.
-
Click Save changes.
-
In the Configuration properties pane, expand
QOS and select Retry
Policy.
The Settings for 'Retry Policy' page
appears.
-
Select Edit settings.
The (Retry Policy) Edit Settings page
appears.
-
For the Retry policy configurations, see Configuring a third-party CMS for integration with Unica Content Integration.
-
Click Save changes.
-
-
Disable all the security checks for the DX_CCORE webhook url from
/webhook/DX-CORE/events/*
Note: Make to give the correct system Identifier.
Default value is DX-CORE.
- API URI -
/webhook/DX-CORE/events/*
- Block API access - Disabled
- Secure API access over HTTPS -
Enabled/Disabled as per your environment requirements.
- Required authentication for API access -
Disabled
- Authentication mode - Not Required
- Data source credential holder - Not
Required
- Data source - Not Required
-
Setting up HCL DX - Media Library
-
Select .
The Configuration page
appears.
-
From the Configuration categories panel, expand .
The Create category from template for the
(CMS Configuration Template)
appears.
-
Provide values for the following fields and click Save
changes:
- New category name - Specify an
appropriate name to identify the new CMS. For example,
HCL DX - Media Library.
- System Identifier -
DX.
- User credentials - Default user
- defaultUserCredentials - asm_admin
- Data source name for credentials -
DX_NEW_DS
- Anonymous Content Access - Set this to
Yes.
- additionalParameters - Provide a ringapi URL for
authenticating HCL DX - Media Library.
For example, apiLogonUrl:
http://<domain-name>:port-number/dx/api/core/v1/auth/login.
.
For more information about the fields, see Configuring a third-party CMS for integration with Unica Content Integration.
-
Click Save changes.
-
Ensure that the Data source name for credentials
field is blank.
-
In the Configuration properties pane, expand
HCL DX - Media Library and select
HTTP Gateway.
The Settings for 'HTTP Gateway' page
appears.
-
Select Edit settings.
The (HTTP Gateway) Edit Settings page
appears.
-
Provide an appropriate for the Base URL field.
Click Save changes.
-
In the Configuration properties pane, expand
HTTP Gateway and select
REST.
The Settings for 'REST' page
appears.
-
Select Edit Settings.
- Base URL - Please contact DX admin to get
these details
- contentBaseUrl - Please contact DX admin
to get these details.
- bypassProxy - No
-
For the Authentication Type field, select the
value None. If
HCL DX - Media
Library
instance is set up to use a different
authentication method, use a different value. For more information about
the available values, see Configuring a third-party CMS for integration with Unica Content Integration.
-
Click Save changes.
-
In the Configuration properties pane, expand
QOS and select Retry
Policy.
The Settings for 'Retry Policy' page
appears.
-
Select Edit settings.
The (Retry Policy) Edit Settings page
appears.
-
For the Retry policy configurations, see Configuring a third-party CMS for integration with Unica Content Integration.
-
Click Save changes.
-
Setting up Azure
-
Select .
The Configuration page
appears.
-
From the Configuration categories panel, expand
The Create category from template for the
Azure appears.
-
Provide values for the following fields and click Save
Changes
-
Click Save changes
-
In the Configuration properties pane, expand
Azure and select HTTP
Gateway.
The settings for HTTP Gateway
appear.
-
Select Edit Settings.
- Base URL - End point of deployed cloud
azure service. For Example:
https://<xxxxx>.cognitiveservices.azure.com
- contentBaseUrl
- bypassProxy
-
Click Save changes.
-
In the Configuration properties pane, expand
HTTP Gateway and select
REST.
The Settings for REST page
appears
-
Select Edit settings
The (REST) Edit Settings page
appears.
-
For the Authentication Type field, select the
value None
-
Click Save changes.
-
Setting up HCL Commerce
-
Select .
The Configuration page
appears.
-
From the Configuration categories panel, expand
The Create category from template for the
HCL Commerce appears.
-
Provide values for the following fields and click Save
Changes
- New category name - Specify an
appropriate name to identify the new CMS. For example, Emerald.
- System Identifier - Commerce
Emerald.
Note: Multiple stores can be onboarded by prefixing
the identifier with Commerce,
followed by a space and the store name. Example: Commerce
Sapphire, Commerce Store 1, Commerce Store 2 and so on.
- User credentials
- defaultUserCredentials
- Data source name for credentials
- Anonymous Content Access
- Additional Parameters - Each parameter
should be separated by new line. Make sure to add a space after
colon [:] while editing the values. Contact commerce admin to
obtain the required values.
- storeId: 11
- contractId: 11005
- langId: -1
- currency: USD
-
Click Save changes
-
In the Configuration properties pane, expand
HTTP Gateway and select
REST.
The
Settings for REST page
appears.
Select Edit settings.
-
Select Edit settings.
The (REST) Edit Settings page
appears.
-
For the Authentication Type field, select the
value None.
-
Click Save changes.
Note: For commerce products, deep search is not supported at category level.
Commerce is looking into this limitation (ticket no: HC-8872) and it will be
addressed in future versions.
-
Setting up Snap-CAST
-
Select .
The Configuration page
appears.
-
From the Configuration categories panel, expand .
The Create category from template for the
Snap-CAST appears.
-
Provide values for the following fields and click Save
changes:
If you face issues with the key-value parameters, contact your
Snap-CAST service provider.
Asset picket will get notified by the user event with user data which
will in turn send user data to
journey.
-
In the Configuration properties pane, expand
Snap-CAST and select HTTP
Gateway.
The Settings for 'HTTP Gateway' page
appears.
-
Select Edit settings.
The (HTTP Gateway) Edit Settings page
appears.
-
For the Snap-CAST Base URL field, see Configuring a third-party CMS for integration with Unica Content Integration.
-
Click Save changes.
-
In the Configuration properties pane, expand
HTTP Gateway and select
REST.
The Settings for 'REST' page
appears.
-
Select Edit settings.
The (REST) Edit Settings page
appears.
-
For the Authentication Type field, select the
value None. If your Snap-CAST instance is set up
to use a different authentication method, use a different value. For
more information about the available values, see Configuring a third-party CMS for integration with Unica Content Integration.
-
Click Save changes.
-
In the Configuration properties pane, expand
QOS and select Retry
Policy.
The Settings for 'Retry Policy' page
appears.
-
Select Edit settings.
The (Retry Policy) Edit Settings page
appears.
-
For the Retry policy configurations, see Configuring a third-party CMS for integration with Unica Content Integration.
-
Click Save changes.
-
Setting up GoogleVision
-
Select .
The Configuration page
appears.
-
From the Configuration categories panel, expand .
The Create category from template for the
GoogleVision appears.
-
Provide values for the following fields and click Save
changes:
- New category name - Specify an
appropriate name to identify the new CMS. For example,
GoogleVision .
- System Identifier -
GoogleVision .
- User credentials
- defaultUserCredentials
- Data source name for credentials
- Anonymous Content Access - When this
field is set to No, then under CMS
configuration, the content preview will not show the download
icon. When set to Yes, it will show the
download icon.
- Additional Parameters - You must
configure the following additional key-value parameters. The
value for the key-value parameters are examples and can be
customized as per your
requirement:
landmarkAnnotationsScoreThreshold: 0.50
labelAnnotationsScoreThreshold: 0.50
localizedObjectAnnotationsScoreThreshold: 0.50
logoAnnotationsScoreThreshold: 0.50
If you do
not configure the above parameters, 0.80
will be considered as the default value.
For more information about the fields, see Configuring a third-party CMS for integration with Unica Content Integration.
-
In the Configuration properties pane, expand
GoogleVision and select HTTP
Gateway.
The Settings for 'HTTP Gateway' page
appears.
-
Select Edit settings.
The (HTTP Gateway) Edit Settings page
appears.
-
For the GoogleVision Base URL field, see Configuring a third-party CMS for integration with Unica Content Integration.
-
Click Save changes.
-
In the Configuration properties pane, expand
HTTP Gateway and select
REST.
The Settings for 'REST' page
appears.
-
Select Edit settings.
The (REST) Edit Settings page
appears.
-
For the Authentication Type field, select the
value None. If your GoogleVision instance is set
up to use a different authentication method, use a different value. For
more information about the available values, see Configuring a third-party CMS for integration with Unica Content Integration.
-
Click Save changes.
-
In the Configuration properties pane, expand
QOS and select Retry
Policy.
The Settings for 'Retry Policy' page
appears.
-
Select Edit settings.
The (Retry Policy) Edit Settings page
appears.
-
For the Retry policy configurations, see Configuring a third-party CMS for integration with Unica Content Integration.
-
Click Save changes.
-
Setting up GoogleLanguage
-
Select .
The Configuration page
appears.
-
From the Configuration categories panel, expand .
The Create category from template for the
GoogleLanguage appears.
-
Provide values for the following fields and click Save
changes:
- New category name - Specify an
appropriate name to identify the new CMS. For example,
GoogleLanguage.
- System Identifier -
GoogleLanguage.
- User credentials
- defaultUserCredentials
- Data source name for credentials
- Anonymous Content Access - When this
field is set to No, then under CMS
configuration, the content preview will not show the download
icon. When set to Yes, it will show the
download icon.
- Additional Parameters
For more information about the fields, see Configuring a third-party CMS for integration with Unica Content Integration.
-
In the Configuration properties pane, expand
Snap-CAST and select HTTP
Gateway.
The Settings for 'HTTP Gateway' page
appears.
-
Select Edit settings.
The (HTTP Gateway) Edit Settings page
appears.
-
For the GoogleLanguage Base URL field, see Configuring a third-party CMS for integration with Unica Content Integration.
-
Click Save changes.
-
In the Configuration properties pane, expand
HTTP Gateway and select
REST.
The Settings for 'REST' page
appears.
-
Select Edit settings.
The (REST) Edit Settings page
appears.
-
For the Authentication Type field, select the
value Basic. If your GoogleLanguage instance is
set up to use a different authentication method, use a different value.
For more information about the available values, see Configuring a third-party CMS for integration with Unica Content Integration.
-
Click Save changes.
-
In the Configuration properties pane, expand
QOS and select Retry
Policy.
The Settings for 'Retry Policy' page
appears.
-
Select Edit settings.
The (Retry Policy) Edit Settings page
appears.
-
For the Retry policy configurations, see Configuring a third-party CMS for integration with Unica Content Integration.
-
Click Save changes.
-
Setting up Mailchimp
-
Select .
The Configuration page
appears.
-
From the Configuration categories panel, expand .
The Settings for Mailchimp page
appears.
-
Provide values for the following fields and click Save
changes:
- System Identifier -
Mailchimp.
- User credentials - Default User
- defaultUserCredentials - asm_admin
- Data source name for credentials - Name
added in this field should be same as user datasouce name.
Credentials will be user name - user (all lower case) and for
password refer -
- Anonymous Content Access
-
In the Configuration properties pane, expand
Mailchimp and select
httpGateway.
The Settings for 'httpGateway' page
appears.
-
Select Edit settings.
The (httpGateway) Edit Settings page
appears.
-
For the Mailchimp Base URL field, the URL
comprises of datasource followed by mailchimp login. For example -
https://<data_center>.api.mailchimp.com/3.0/. Refer
-
Click Save changes.
-
In the Configuration properties pane, expand
HTTP Gateway and select
REST.
The Settings for 'REST' page
appears.
-
Select Edit settings.
The (REST) Edit Settings page
appears.
-
For the Authentication Type field, select the
value Basic. If your Mailchimp instance is set up
to use a different authentication method, use a different value.
-
Click Save changes.
-
Disable all the security checks for the mailchimp webhook url from
/webhook/Mailchimp/events/*
- API URI -
/webhook/Mailchimp/events/*
- Block API access - Disabled
- Secure API access over HTTPS -
Enabled/Disabled as per your environment requirements.
- Required authentication for API access -
Disabled
- Authentication mode - Not Required
- Data source credential holder - Not
Required
- Data source - Not Required
Mailchimp Integration with Unica To integrate Mailchimp
application with Unica system, complete the following list of
procedures:
Signing Up and Signing into Mailchimp account
- Access the following URL:
https://login.mailchimp.com/
- To create an account, use either your official email
address, Gmail account or Facebook. If required, you can
continue with your Google account or Apple account.
API key generation
- For generating API key, navigate to .
- The screen will have a link that will help in creating a
key.
- Click Create a Key.
- Your API key will be generated.
- User can generate multiple API keys and integrate them with
different data sources in Platform.
Note: This key will be the password
while setting up mailchimp data source in platform.
Create data source in Platform (Mailchimp)
Configuring the out-of-the-box integrations offered by Content Integration
Set Audience
After Mailchimp account is
created successfully, user can set one or multiple audiences. This
is an optional step, user can continue with existing audiences. For
setting Audience follow the below steps:
- Navigate to .
- Click Audience Fields and *|MERGE|*
tags.
- Provide values to the visible fields
- Click on Add a Field for adding new
fields (if required)
Create Webhook
- Before creating a webhook security checks needs to be
disabled. Refer
- Navigate to .
- Click Webhook
- Add URL in Configured webhooks
fields
- Click Create New Webhook
Note: The added url
(https://<unica-domain>/asset-viewer/api/AssetPicker/webhook/Mailchimp/events/webhook_listener)
should be publicly available on internet. Update the
Unica domain as per your environment.
- Select all the available option
- Click Update
Add Subscriber (Optional)
- Navigate to .
- Provide values for the following fields:
- Email Address
- First Name
- Last Name
- Address
- …… so on
- Click Update
Note: Refer Mailchimp system to invite a
subscriber and update profile.
Content Integration
Framework will get notified by the user event with user data which
will in turn send user data to Journey.
-
Setting up Journey
-
Access the Unica Journey application with administrator
privileges.
-
Open the Unica Journey Administrator's Guide and perform
the steps mentioned in .
-
Access the Unica Platform application.
-
Select > Users.
-
Select the username you want to register for app credentials. For
example,
asm_admin
.
-
Click Edit data sources.
-
Click Add new.
-
For the Data source field, provide the value
JOURNEY_DS.
-
For the Data source login field, provide the
value of Client ID that you copied from the
app.
-
For the Data source password and
Confirm password fields, provide the value of
Client Secret that you copied from the
app.
-
Click Save changes.
-
From the Configuration categories panel, expand .
The Settings for Journey page
appears.
-
Provide values for the following fields and click Save
changes:
- System Identifier -
Journey.
- User credentials - Default
User
- defaultUserCredentials -
asm_admin
- Data source name for credentials -
JOURNEY_DS (as set up in Step
h.
- Anonymous Content Access -
Yes
-
Select HTTP Gateway and click Edit
settings.
-
For the Base URL field, provide the value
http://<unica_domain>/journey
and click Save changes, where:
<unica_domain> is the
domain name or host name where the Journey is hosted.
-
Select REST and click Edit
settings.
-
For the Authentication Type field, provide the
value None and click Save
changes.
-
Setting up Slack