创建 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 分钟左右，让问题自行解决。