On-Demand Sandbox の作成

On-Demand Sandbox (ODS) は、開発とテストの目的で使用する B2C Commerce の特殊なインスタンスです。ODS インスタンスは一時的なものですが、最大 90 日まで使用可能です。

PWA Kit ストアフロントのコードには、カタログや顧客、買い物カゴなどの情報データは含まれていません。この重要なコマースデータを取得するために、ヘッドレス API を使用して e コマースのバックエンドにリクエストする必要があります。

ほとんどの PWA Kit プロジェクトは、少なくとも 1 つの On-Demand Sandbox を使用して開始します。この On-Demand Sandbox は、ストアフロントコードの開発中にバックエンドとして機能します。開発チームによっては、少数の Sandbox を共有する場合や、異なる目的のために別々の Sandbox を作成する場合があります。

Account Manager で Sandbox API User の役割をもつすべてのユーザーが、ODS を作成できます。役割の範囲は特定のレルムに限られているため、ODS を作成するにはレルムの 4 文字の ID を把握している必要があります。レルム ID がわからない場合は、アカウントエグゼクティブ (AE) または Customer Success Manager (CSM) までお問い合わせください。

また、Sandbox 作成用のクライアント ID を把握しているか、または別の管理者がクライアント 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. Authorize (認証) をクリックします。

  3. Sandbox 作成用のクライアント ID を入力します。

  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. <your realm id> を実際のレルム ID に置き換えます。例: zzdc。

  12. Sandbox を 24 時間以上使用可能にしたい場合は、ttl の値を最高 2160 時間 (90 日) までの任意の時間に置き換えます。

  13. また、削除するまで Sandbox が存続するようにするには、ttl に 0 以下を入力します。

  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 (Salesforce B2C Commerce のオンデマンド Sandbox)

PWA Kit プロジェクトは、サンプルデータが含まれている B2C Commerce インスタンスから開始することをお勧めします。

サンプルデータをインスタンスにインポートするには:

  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 アクセスの設定に進みましょう。