辅助服务模块 (ASM) 使客户服务人员能够使用 Spartacus 店面提供实时客户销售和服务支持。
Spartacus 中的辅助服务模块功能需要 SAP Commerce Cloud 版本 1905.5 或更高版本。 在 assistedservicewebservices 端点中启用 CORS 需要最低版本 1905.5。
Spartacus 中的 ASM 需要以下 SAP Commerce Cloud 扩展：
- assistedservicewebservices extension
- assistedservicestorefront AddOn
要在 Spartacus 中启用 ASM，需要执行以下部分中的步骤：
- 授予 CMS 权限
- 配置 CORS
asagentgroup 用户组需要特定权限才能从 OCC 读取 CMS 数据。
如果从头开始并使用 1905.5 或更高版本初始化 SAP Commerce Cloud 系统，则 asagentgroup 将获得通过 Spartacus 和 OCC 使用 CMS 数据所需的权限。 无需采取进一步行动。
但是，如果从早于 1905.5 的版本升级 SAP Commerce Cloud，则需要通过 ImpEx 控制台导入以下 ImpEx 数据来授予 asagentgroup 权限：
# Access rights for asagentgroup # - These are needed for rendering (cmsoccaddon). $START_USERRIGHTS;;;;;;;;; Type;UID;MemberOfGroups;Password;Target;read;change;create;remove;change_perm UserGroup;asagentgroup;;;;;;;; # general ;;;;Item;+;;;;; ;;;;Type;+;;;;; # access rights for Products, Store, Site and Catalogs ;;;;Product;+;;;;; ;;;;Category;+;;;;; ;;;;VariantType;+;;;;; ;;;;BaseSite;+;;;;; ;;;;BaseStore;+;;;;; ;;;;Catalog;+;;;;; ;;;;CatalogVersion;+;;;;; ;;;;ContentCatalog;+;;;;; ;;;;MediaContainer;+;-;-;-;-; ;;;;MediaContext;+;-;-;-;-; ;;;;MediaFormat;+;-;-;-;-; ;;;;MediaFormatMapping;+;-;-;-;-; # cms2 items ;;;;CMSItem;+;-;-;-;-; $END_USERRIGHTS;;;;;
Configuring CORS
assistedservicewebservices 扩展需要 CORS 配置，这可以通过 SAP Commerce Cloud 版本 1905.5 或更高版本实现。 assistedservicewebservices 的 CORS 配置具有在 assistedservicewebservices 的 project.properties 文件中指定的默认值。 默认值如下：
corsfilter.assistedservicewebservices.allowedOrigins=http://localhost:4200 https://localhost:4200 corsfilter.assistedservicewebservices.allowedMethods=GET HEAD OPTIONS PATCH PUT POST DELETE corsfilter.assistedservicewebservices.allowedHeaders=origin content-type accept authorization
Customizing the CORS Configuration
通过 local.properties 文件覆盖默认配置来自定义 CORS 配置。
由于配置在 local.properties 中被覆盖，如果要添加配置元素而不丢失默认值，则除了任何新元素之外，还需要添加所有默认值。 例如，要在 allowedHeaders 列表中添加 my-new-header，除了默认标头之外，还需要在 local.properties 文件中添加以下内容：
corsfilter.assistedservicewebservices.allowedHeaders=origin content-type accept authorization my-new-header.
要自定义 allowedMethods 或 allowedHeaders，应该添加到默认值。
要自定义 assistedservicewebservices 的 allowedOrigins 属性，需要使用与您的环境相关的主机名覆盖（即替换）local.properties 文件中的默认值。 下面是一个例子：
corsfilter.assistedservicewebservices.allowedOrigins=https://my-new-host:4200
仅出于开发目的，可以将值设置为通配符 (*)，如以下示例所示：
orsfilter.assistedservicewebservices.allowedOrigins=*
注意：这种通配符配置对于开发环境很灵活，但并不安全。 生产使用需要更严格的配置。
