建立 On-Demand Sandbox

如果您已有 B2C Commerce 執行個體,則可以在產生專案時連接到它。在這種情況下,您可以跳過以下步驟,因為您不需要 On-Demand Sandbox。

Note

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

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

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

本指南可説明您在沒有工具或自動化的情況下儘快開始使用 PWA Kit。以下步驟將指導您創建按需沙箱、導入演示網站以及使用演示數據。要創建 ODS 來測試您自己的代碼和數據,請參閱 On-Demand Sandboxes 入門

先決條件 

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

此外,您必須知道用戶端 ID 才能建立 Sandbox,或由另一位管理員為您建立一個。若您不知道建立 Sandbox 的用戶端 ID,請洽詢團隊中另一位 B2C Commerce 管理員。(Salesforce 內部使用者可以在這篇 Concierge 文章中獲得用戶端 ID。)

使用 Sandbox REST API 

若要使用 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 欄位:

    1{
    2  "realm": "<your realm id>",
    3  "ttl": 24,
    4  "autoScheduled": false,
    5  "resourceProfile": "medium"
    6}
  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:開始使用 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 分鐘,以待問題自行解決。

也請參閱