创建 On-Demand Sandbox(按需沙盒)

如果您已有 B2C Commerce 实例,则可以在生成项目时连接到该实例。在这种情况下,您可以跳过以下步骤,因为您不需要 On-Demand Sandbox。

On-Demand Sandbox (ODS) 是一种特殊的 B2C 商务实例,用于开发和测试目的。尽管 ODS 实例只是临时的,但它们最多可以使用 90 天。

PWA Kit 网店的代码不包含有关目录、客户、购物篮等的信息数据。要获取关键的商业数据,它需要使用无标头 API 从电子商务后端请求。

大多数 PWA Kit 项目从至少一个 On-Demand Sandbox 开始,在开发网店代码时用作后端。一些开发团队共享少量 Sandbox,而其他开发团队则为不同目的创建许多不同的 Sandbox。

在 Account Manager 中具有 Sandbox API 用户角色的任何人都可以创建 ODS。因为角色的范围是特定域,所以您必须知道自己的域的四字符 ID 才能创建 ODS。如果不知道自己的域 ID,请询问 Account Executive (AE) 或 Customer Success Manager (CSM)。

此外,您还必须知道用于创建 Sandbox 的客户端 ID,或者让另一位管理员帮助创建一个。如果不知道 Sandbox 创建客户端 ID,请让团队中的另一位 B2C Commerce 管理员分享。(Salesforce 内部用户可以从 这篇 Concierge 文章 中获取客户端 ID。)

要使用 B2C Commerce Developer Sandbox REST API 创建 On-Demand Sandbox:

  1. 转至 B2C Commerce Developer Sandbox REST API。(Salesforce 内部用户必须使用不同的 URL。)

  2. 点击授权

  3. 输入用于创建 Sandox 的客户端 ID。

  4. 点击授权

  5. 使用您的 Account Manager 登录信息登录。

  6. 要关闭授权窗口并返回到 Sandbox API 用户界面,请点击关闭

  7. 在 Sandbox API 用户界面的 Sandbox 部分,点击展开 POST/sandboxes 方法。

  8. 点击试用

  9. 删除 ProvisioningRequest 字段中的 JSON 对象。

  10. 复制以下 JSON 对象并将其粘贴到 ProvisioningRequest 字段中:

  11. <your realm id> 替换为您的实际领域 ID。示例:zzdc

  12. 如果希望 Sandbox 的可用时间超过 24 小时,请将 ttl 值替换为不超过 2160(90 天)的任意小时数。

  13. 也可以为 ttl 输入 0 或更少,以指定 Sandbox 持续到将其删除。

  14. 点击执行

  15. 如果 ProvisioningRequest JSON 有效,则会显示服务器响应。

  16. 复制响应正文或点击下载,以便以后参考。

在下一部分中,将需要 Sandbox 的 Business Manager URL。Business Manager URL 可以在 data.links.bm 中的响应正文对象中找到。

Business Manager URL 如下所示(但具有基于域 ID 和实例 ID 的唯一主机名):https://zzdc-001.dx.commercecloud.salesforce.com/on/demandware.store/Sites-Site

B2C Commerce Infocenter 提供了有关 On-Demand Sandbox 的更多帮助:开始使用 On-Demand Sandbox

还提供了更详细的 Trailhead 模块:Salesforce B2C Commerce On-Demand Sandboxes

我们建议使用包含示例数据的 B2C Commerce 实例来启动您的 PWA Kit 项目。

要将示例数据导入实例:

  1. 转到您的实例的 Business Manager URL。(如果您刚刚创建 ODS,则可能需要大约 10 分钟才能使用 Business Manager。)
  2. 使用您的 Account Manager 登录信息登录。
  3. 转到管理 >** 站点开发** > 站点导入和导出
  4. 选择 Storefront Reference Architecture 演示站点
  5. 点击导入
  6. 选择 Storefront Reference Architecture 库
  7. 点击部署
  8. 点击刷新以跟踪部署进度。

部署过程完成后(大约 15 分钟),实例将包含可在使用 PWA Kit 进行开发时使用的示例数据。

在示例数据完成部署后,重建搜索索引以反映新数据:

  1. 转到您的实例的 Business Manager URL。
  2. 使用您的 Account Manager 登录信息登录。
  3. 前往**商家工具 > **搜索 > 搜索索引
  4. 选择所有索引。
  5. 点击重建

如果在创建新 ODS 后不久在 PWA Kit 网店看到损坏的目录图像,请再等待 10 分钟左右,让问题自行解决。