建立 On-Demand Sandbox

On-Demand Sandbox (ODS) 是專為進行開發和測試的特殊 B2C Commerce 執行個體。雖然 ODS 執行個體只是暫時使用，但可用時間最高可達 90 天。

您的 PWA Kit 網店程式碼不包含目錄、客戶、購物車等資訊的資料。為了獲得重要的商務資料，需要從電子商務後端使用無頭式 API 要求資料。

大部分 PWA Kit 專案都是先從至少一個 On-Demand Sandbox 開始，作為開發網店程式碼的後端。有的開發團隊會共用少數幾個 Sandbox，而其他團隊會為不同目的建立多個不同 Sandbox。

任何在 Account Manager 中擁有 Sandbox API User 角色的人都可建立 ODS。因為這個角色受限於特定領域，您必須知道領域的 4 字元 ID，才能建立 ODS。若您不知道領域 ID，請洽詢您的業務專員 (AE) 或 Customer Success Manager (CSM)。

此外，您必須知道用戶端 ID 才能建立 Sandbox，或由另一位管理員為您建立一個。若您不知道建立 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. 按一下 [Authorize] (授權)。

  3. 輸入用戶端 ID 來建立 Sandbox。

  4. 按一下 [Authorize] (授權)。

  5. 使用您的 Account Manager 憑證登入。

  6. 若要關閉授權視窗並返回 Sandbox API 使用者介面，按一下 [Close] (關閉)。

  7. 在 Sandbox API 使用者介面的 Sandboxes 區塊中，按一下來展開 POST/sandboxes 方法。

  8. 按一下 [Try it out] (嘗試)。

  9. 刪除 ProvisioningRequest 欄位中的 JSON 物件。

  10. 複製以下 JSON 物件並貼上至 ProvisioningRequest 欄位：

  11. 用您真正的領域 ID 取代 <your realm id>。範例：zzdc。

  12. 若您希望 Sandbox 可用時間超過 24 小時，請以 2160 小時 (90 天) 以下的數字取代 ttl 值。

  13. 您也可以為 ttl 填入 0 或更小的值，這樣可以指定讓此 Sandbox 留存到您將其刪除為止。

  14. 按一下 [Execute] (執行)。

  15. 若 ProvisioningRequest JSON 有效，則會顯示伺服器回應。

  16. 複製回應內容，或按一下 [Download] (下載) 以供日後參考。

在下一區塊中，您的 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

如需更多 On-Demand Sandbox 的協助，可前往 B2C Commerce Infocenter：Get Started with On-Demand Sandboxes (開始使用 On-Demand Sandbox)。

也可參考更加詳細的 Trailhead 模組：Salesforce B2C Commerce On-Demand Sandboxes。

我們建議您使用包含範例資料的 B2C Commerce 執行個體來開始 PWA Kit 專案。

若要匯入範例資料至執行個體：

  1. 前往執行個體的 Business Manager URL。(若您才剛建立 ODS，Business Manager 可能需要大約 10 分鐘才可使用。)
  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 分鐘，以待問題自行解決。

  • 這樣您就已經設定好擁有範例資料的 On-Demand Sandbox 了，請繼續完成「開始使用」系列的下一篇指南：設定 API 存取。