Content Integration offers the following
out-of-the-box integrations: Adobe Experience Manager (AEM), HCL WCM, HCL Digital Experience
(DX), 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: From version 12.1.0.4 onwards, 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)
-
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:
-
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.
Note: The Base URL will not be used for authentication if the
HCL DX - Media Library
repository is configured
with a ringapi URL for authentication for the
additionalParamters field.
-
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 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.
-
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
- defaultUserCredentials
- Data source name for credentials
- 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.
If you keep this field blank, the value provided for
the Base URL parameter in HCL
DX repository will be used for authentication.
See Step 5 for more details.
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.
The (REST) Edit Settings page
appears.
-
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:
-
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.