建立 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.sandbox.us01.dx.commercecloud.salesforce.com/on/demandware.store/Sites-Site

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

也可參考更加詳細的 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 存取