SAPCOMMERCE CLOUD sap-commerce-cloud

Last update: Mon Jul 15 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

主题：
商务集成框架

创建对象：

管理员
开发人员

安装后，您可以配置实例：

配置Geometrixx Outdoors的分面搜索。
配置目录版本。
配置导入结构。
配置要加载的产品属性。
正在导入产品数据。
配置目录导入程序。
使用导入程序将目录导入到AEM中的特定位置。

配置Geometrixx Outdoors的分面搜索 configure-the-facetted-search-for-geometrixx-outdoors

NOTE

hybris 5.3.0.1及更高版本不需要此参数。

在浏览器中，导航到 hybris管理控制台，网址为：

http://localhost:9001/hmc/hybris
从侧栏中，依次选择系统、Facet搜索 和 Facet搜索配置。
为clothescatalog 的示例Solr配置打开 编辑器。
在 目录版本 下，使用 添加目录版本 将outdoors-Staged和outdoors-Online添加到列表。
保存配置。

打开 SOLR项类型 以将 SOLR排序 添加到ClothesVariantProduct：

相关性（“相关性”，分数）
name-asc (“名称（升序）”， name)
name-desc (“Name(descending)”， name)
price-asc(“Price(ascending)”， priceValue)
price-desc(“价格（降序）”， priceValue)

note note
NOTE
使用上下文菜单（通常是右键单击菜单）选择`Create Solr sort`。
对于Hybris 5.0.0，打开`Indexed Types`选项卡，双击`ClothesVariantProduct`，然后单击选项卡`SOLR Sort`。

chlimage_1-36

在 索引类型 选项卡中，将 合成类型 设置为：

Product - Product

在 索引类型 选项卡中，调整full的 索引器查询：

code language-shell
`SELECT {pk} FROM {Product} WHERE {pk} NOT IN ({{SELECT {baseProductpk} FROM {variantproduct}}})`

在 索引类型 选项卡中，调整incremental的 索引器查询：

code language-shell
`SELECT {pk} FROM {Product} WHERE {pk} NOT IN ({{SELECT {baseProductpk} FROM {variantproduct}}}) AND {modifiedtime} <= ?lastIndexTime`

在 索引类型 选项卡中，调整category方面。双击类别列表中的最后一个条目以打开 索引属性 选项卡：

note note
NOTE
对于hybris 5.2，请确保根据以下屏幕快照选择Properties表中的`Facet`属性：

chlimage_1-37 chlimage_1-38

打开 Facet设置 选项卡并调整字段值：
保存更改。
再次从 SOLR项类型 中，根据以下屏幕截图调整price Facet。与category一样，双击price以打开 索引属性 选项卡：
打开 Facet设置 选项卡并调整字段值：
保存更改。
打开系统、Facet搜索，然后打开 索引器操作向导。启动cronjob：
- 索引器操作： full
- Solr配置： Sample Solr Config for Clothes

配置目录版本 configure-the-catalog-version

可以为OSGi服务配置导入的 目录版本 (hybris.catalog.version)：

Day CQ Commerce Hybris配置
(com.adobe.cq.commerce.hybris.common.DefaultHybrisConfigurationService)

目录版本 设置为Online或Staged（默认值）。

NOTE

使用AEM时，可通过多种方法管理此类服务的配置设置；有关完整的详细信息，请参阅配置OSGi。有关可配置参数及其缺省值的完整列表，另请参阅控制台。

日志输出提供关于所创建页面和组件的反馈，并报告潜在的错误。

配置导入结构 configure-the-import-structure

以下列表显示了默认情况下创建的示例结构（由资产、页面和组件组成）：

+ /content/dam/path/to/images
  + 12345.jpg (dam:Asset)
    + ...
  + ...
+ /content/site/en
  - cq:commerceProvider = "hybris"
  - cq:hybrisBaseStore = "basestore"
  - cq:hybrisCatalogId = "catalog"
  + category1 (cq:Page)
    + jcr:content (cq:PageContent)
      - jcr:title = "Category 1"
    + category11 (cq:Page)
      + jcr:content (cq:PageContent)
        - jcr:title = "Category 1.1"
      + 12345 (cq:Page)
        + jcr:content (cq:PageContent)
          + par
            + product (nt:unstructured)
              - cq:hybrisProductId = "12345"
              - sling:resourceType = "commerce/components/product"
              + image (nt:unstructured)
                - sling:resourceType = "commerce/components/product/image"
                - fileReference = "/content/dam/path/to/images/12345.jpg"
              + 12345.1-S (nt:unstructured)
                - cq:hybrisProductId = "12345.1-S"
                - sling:resourceType = "commerce/components/product"
                + image (nt:unstructured)
                  - sling:resourceType = "commerce/components/product/image"
                  - fileReference = "/content/dam/path/to/images/12345.1-S.jpg"
              + ...

此类结构由实现ImportHandler接口的OSGi服务DefaultImportHandler创建。实际导入程序会调用导入处理程序，以创建产品、产品变体、类别、资产等。

NOTE

您可以通过实施自己的导入处理程序来自定义此进程。

可以为以下配置导入时要生成的结构：

Day CQ Commerce Hybris默认导入处理程序
(com.adobe.cq.commerce.hybris.importer.DefaultImportHandler)

配置要加载的产品属性 configure-the-product-attributes-to-load

响应分析器可以配置为定义要为（变体）产品加载的属性和属性：

配置OSGi捆绑包：

Day CQ Commerce Hybris默认响应分析器
(com.adobe.cq.commerce.hybris.impl.importer.DefaultResponseParser)

您可以在此定义加载和映射所需的各种选项和属性。

note note
NOTE
使用AEM时，可通过多种方法管理此类服务的配置设置；有关完整的详细信息，请参阅配置OSGi。有关可配置参数及其缺省值的完整列表，另请参阅控制台。

导入产品数据 importing-the-product-data

有多种方式可导入产品数据。可在最初设置环境时或在hybris数据中进行更改后导入产品数据：

完全导入
增量导入
快速更新

从hybris导入的实际产品信息保存在存储库中的以下位置：

/etc/commerce/products

以下属性指示与hybris的链接：

commerceProvider
cq:hybrisCatalogId
cq:hybrisProductID

NOTE

hybris实现（即geometrixx-outdoors/en_US）只在/etc/commerce下存储产品ID和其他基本信息。

每次请求有关产品的信息时，都会引用hybris服务器。

完全导入 full-import

如有必要，请使用CRXDE Lite删除所有现有的产品数据。
1. 导航到包含产品数据的子树：
  
  /etc/commerce/products
  
  例如：
  
  http://localhost:4502/crx/de/index.jsp#/etc/commerce/products
2. 删除保存产品数据的节点；例如，outdoors。
3. 全部保存 以保留更改。
在AEM中打开hybris导入程序：

/etc/importers/hybris.html

例如：

http://localhost:4502/etc/importers/hybris.html
配置所需的参数；例如：

单击 导入目录 开始导入。

完成后，您可以验证导入的数据：

code language-none
`/etc/commerce/products/outdoors`

您可以在CRXDE Lite中打开此项；例如：

[http://localhost:4502/crx/de/index.jsp#/etc/commerce/products](http://localhost:4502/crx/de/index.jsp#/etc/commerce/products)

增量导入 incremental-import

检查AEM中相关产品的信息，位于以下相应子树中：

/etc/commerce/products

您可以在CRXDE Lite中打开此项；例如：

http://localhost:4502/crx/de/index.jsp#/etc/commerce/products
在Hybris中，更新相关产品上的信息。
在AEM中打开hybris导入程序：

/etc/importers/hybris.html

例如：

http://localhost:4502/etc/importers/hybris.html
选中 增量导入 复选框。

单击 导入目录 开始导入。

完成后，您可以在下面验证AEM中更新的数据：

code language-none
`/etc/commerce/products`

快速更新 express-update

导入过程可能需要较长时间，因此，作为产品同步的扩展，您可以选择目录的特定区域以进行手动触发的快速更新。这会使用导出信息源以及标准属性配置。

检查AEM中相关产品的信息，位于以下相应子树中：

/etc/commerce/products

您可以在CRXDE Lite中打开此项；例如：

http://localhost:4502/crx/de/index.jsp#/etc/commerce/products
在Hybris中，更新相关产品上的信息。
在hybris中，将一个或多个产品添加到Express队列；例如：
在AEM中打开hybris导入程序：

/etc/importers/hybris.html

例如：

http://localhost:4502/etc/importers/hybris.html
选中 快速更新 复选框。

单击 导入目录 开始导入。

完成后，您可以在下面验证AEM中更新的数据：

code language-none
`/etc/commerce/products`

配置目录导入程序 configure-the-catalog-importer

使用hybris目录、类别和产品的批次导入器，可以将hybris目录导入AEM。

导入器使用的参数可以配置用于：

Day CQ Commerce Hybris目录导入程序
(com.adobe.cq.commerce.hybris.impl.importer.DefaultHybrisImporter)

目录导入 catalog-import

hybris包附带一个目录导入程序，用于设置初始页面结构。

该功能可从以下位置获取：

http://localhost:4502/etc/importers/hybris.html

ecommerceimportconsole

必须提供以下信息：

基础存储
在hybris中配置的基本存储的标识符。
目录
要导入的目录的标识符。
根路径
目录应导入到的路径。

从目录中删除产品 removing-a-product-from-the-catalog

要从目录中删除一个或多个产品，请执行以下操作：

为OSGi服务配置 Day CQ Commerce Hybris目录导入程序；另请参阅配置目录导入程序。

激活以下属性：

启用产品移除
启用产品资产删除

note note
NOTE
使用AEM时，可通过多种方法管理此类服务的配置设置；有关完整的详细信息，请参阅配置OSGi。有关可配置参数及其缺省值的完整列表，另请参阅控制台。

通过执行两次增量更新初始化导入程序（请参阅目录导入）：

首次运行会生成一组已更改的产品，如日志列表中所示。
这已是第二次不更新任何产品了。

note note
NOTE
第一个导入是初始化产品信息。第二次导入验证所有组件是否正常工作，以及是否已准备好。

选中包含要删除的产品的类别页面。产品详细信息应可见。

例如，以下类别显示了Cajamara产品的详细信息：

http://localhost:4502/editor.html/content/geometrixx-outdoors/en_US/equipment/biking.html
在hybris控制台中删除该产品。使用选项 更改审批状态 将状态设置为unapproved。将从实时信息源中删除产品。

例如：
- 打开页面http://localhost:9001/productcockpit
- 选择目录Outdoors Staged
- 搜索Cajamara
- 选择此产品并将审批状态更改为unapproved
执行另一个增量更新（请参阅目录导入）。日志中列出了已删除的产品。
转出相应的目录。已从AEM中删除产品和产品页面。

例如：
- 打开：
  
  http://localhost:4502/aem/catalogs.html/content/catalogs/geometrixx-outdoors-hybris
- 转出Hybris Base目录
- 打开：
  
  http://localhost:4502/editor.html/content/geometrixx-outdoors/en_US/equipment/biking.html
- 已从Bike类别中删除Cajamara产品
要恢复产品，请执行以下操作：
1. 在Hybris中，将审批状态设回 已批准
2. 在AEM中：
  1. 执行增量更新
  2. 再次转出相应的目录
  3. 刷新相应的类别页面

将订单历史记录特征添加到客户端上下文 add-order-history-trait-to-the-client-context

要将订单历史记录添加到客户端上下文，请执行以下操作：

通过以下任一方式打开客户端上下文设计页面：
- 打开页面进行编辑，然后使用 Ctrl-Alt-c (windows)或 control-option-c (Mac)打开客户端上下文。使用客户端上下文左上角的铅笔图标来 打开ClientContext设计页。
- 直接导航到http://localhost:4502/etc/clientcontext/default/content.html
将 订单历史记录 组件添加到客户端上下文的 购物车 t组件中。

您可以确认客户端上下文显示订单历史记录的详细信息。例如：

打开客户端上下文。
将项目添加到购物车。
完成结帐。
检查客户端上下文。
将另一项目添加到购物车。
导航到结账页面：
- 客户端上下文显示订单历史记录的摘要。
- 将显示“You are a returning customer（您是旧客户）”消息。

note note
NOTE
该消息通过以下方式实现：
导航到http://localhost:4502/content/campaigns/geometrixx-outdoors/hybris-returning-customer.html 营销策划包含一个体验。单击区段(http://localhost:4502/etc/segmentation/geometrixx-outdoors/returning-customer.html) 区段是使用订单历史记录属性特征生成的。

recommendation-more-help

19ffd973-7af2-44d0-84b5-d547b0dffee2