SAP Spartacus 中的 HTTP URL parameters

使用带有参数请求选项的 ​​HttpParams​​ 类在 HttpRequest 中添加 URL 查询字符串。

下面的例子，searchHeroes() 方法查询名字中包含搜索词的英雄。

首先导入 HttpParams 类，如下图高亮代码所示：

如果有搜索词，代码会使用 HTML URL 编码的搜索参数构造一个选项对象。 例如，如果术语是“cat”，则 GET 请求 URL 将是 api/heroes?name=cat。

HttpParams 对象是不可变的。 如果您需要更新选项，请保存 .set() 方法的返回值。

下面是 Spartacus Customer Search 的一个例子：

上述代码设置了两个参数，​​baseSite​​​ 值为当前处于 active 状态的 base site 值，而 sort 参数硬编码为 ​​byNameAsc​​.

使用用户名 ​​asagent​​​ 登录 ASM module 之后，在 customer 字段输入客户名，比如 ​​jerry​​，能看到 Chrome 开发者工具 network 面板的请求：

url：

​​https://xxx:9002/assistedservicewebservices/customers/search?baseSite=electronics-spa&sort=byNameAsc&query=jerry&pageSize=20​​

url 里的 query 和 pageSize 的参数，设置代码如下：

customerSearch(
    options: CustomerSearchOptions
  ): Observable<CustomerSearchPage> {
    const headers = InterceptorUtil.createHeader(
      USE_CUSTOMER_SUPPORT_AGENT_TOKEN,
      true,
      new HttpHeaders()
    );
    let params: HttpParams = new HttpParams()
      .set('baseSite', this.activeBaseSite)
      .set('sort', 'byNameAsc');

    if (typeof options['query'] !== 'undefined') {
      params = params.set('query', '' + options.query);
    }

    if (typeof options['pageSize'] !== 'undefined') {
      params = params.set('pageSize', '' + options.pageSize);
    }

    const url = this.occEndpointsService.buildUrl(
      'asmCustomerSearch',
      {},
      {
        baseSite: false,
        prefix: false,
      }
    );

    return this.http
      .get<CustomerSearchPage>(url, { headers, params })
      .pipe(this.converterService.pipeable(CUSTOMER_SEARCH_PAGE_NORMALIZER));
  }

按照 Spartacus 数据交换的惯例，这个 adapter 被 connector 调用：

connector 的 customerSearch 方法被 Customer Effect 调用，后者在接收到 Ngrx ​​AsmActions.CUSTOMER_SEARCH​​ 之后就会触发：

这里提到的 ASM，是 SAP Commerce Cloud 中的一个附加组件。它允许客户服务代表以客户身份登录店面或网站，并获得与客户相同的店面视图。 登录后，代理可以代表客户执行任何操作。

此功能在 ​​b2c_acc_plus​​​ 和 ​​b2b_acc_plus​​ 配方中开箱即用。 但是，如果您已使用其他一些常用模块（例如 b2c_acc 或 b2b_acc）初始化 SAP Hybris，仍然可以使用 ASM 模块。

属于 ​​Agent​​ 或其相关组的任何员工都可以像任何客户一样登录和模拟，并执行客户可以执行的所有操作。