輔助服務模組 (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 許可權：

```sql
# 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;;;;;
```

[外鏈圖片轉存失敗,源站可能有防盜鏈機制,建議將圖片儲存下來直接上傳(img-o8tEMtYv-1660574832212)(https://upload-images.jianshu.io/upload_images/2085791-f60896638bf390cc.png?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240)]

# Configuring CORS

assistedservicewebservices 擴充套件需要 CORS 配置，這可以透過 SAP Commerce Cloud 版本 1905.5 或更高版本實現。 assistedservicewebservices 的 CORS 配置具有在 assistedservicewebservices 的 project.properties 檔案中指定的預設值。 預設值如下：

```sql
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=*

注意：這種萬用字元配置對於開發環境很靈活，但並不安全。 生產使用需要更嚴格的配置。

![](https://img-blog.csdnimg.cn/img_convert/8cb5ef03745653fcc77da37329ddb4b3.png)

SAP 電商雲 Spartacus UI 裡的 ASM 模組啟用的前置條件

相關文章