Commerce B2B ストアフロント作成

Salesforce で Commerce B2B ストアを作成し、自動生成されたストアフロント メタデータをリポジトリに取得するインタラクティブ ワークフロー。

重要な概念

Commerce B2B = ストア (バックエンド データ) + ストアフロント (フロントエンド メタデータ)。ストアフロントを自動生成するには、まずストアを org 内に作成する必要があります。ストアフロント メタデータを手動で作成しないでください。

ストア vs ストアフロント リファレンスを参照

このスキルを使用する場合

ユーザーが以下をリクエストした場合にトリガーします:

• 「B2B Commerce ストアを作成したい」
• 「Commerce ストアフロントを構築したい」
• 「Commerce B2B をセットアップしたい」
• 「B2B Commerce を作成したい」
• 「Commerce ストアフロント メタデータを取得したい」
• 「B2B ストアフロントをデプロイしたい」

常に適用されるルール

1. 必ずインタラクティブ フローに従う。 ステップをスキップしないでください。各ステップは進む前にユーザーの確認が必要です。

2. ストアフロント メタデータを手動で作成しない。 Commerce セットアップ ウィザードは数百の設定値を生成します。手動作成は失敗します。

3. 取得前に必ずサイトをリストする。 ストア名にはアンダースコアと数字サフィックスが付きます (例: 「My B2B Store」→「My_B2B_Store1」)。ユーザーが実際のリストから選択できるようにします。

4. 常に --json フラグを使用する。 すべての Salesforce CLI コマンドで --json を含めて、解析可能な出力を取得します。

インタラクティブ ワークフロー: 7 ステップ

ステップ 1: Commerce B2B コンセプトを説明

エージェントが説明: Commerce には ストア (データ) + ストアフロント (メタデータ) があります。ストアを最初に作成する必要があります。

参照: ストア vs ストアフロント リファレンス

---

ステップ 2: B2B ストア作成をユーザーにガイド

エージェントが以下のステップを提供:

1. Setup → Commerce → Stores に移動

   • または: App Launcher → Commerce → Create Store

2. 「Create Store」 または 「Setup New Store」 をクリック

3. ストア タイプとして 「Commerce Store」 を選択

4. ウィザードに従う:

   • Store Name: 説明的な名前を選択 (例: 「My B2B Store」)
     • 重要: スペースはフォルダ名ではアンダースコアになります
   • Site URL: サイトの一意の URL 名

5. ウィザードを完了 - 以下が作成されます:

   • WebStore レコード
   • デフォルト バイヤー グループとエンタイトルメント ポリシー
   • 関連付けられた Digital Experience (LWR サイト)

6. オプション: 支払いゲートウェイ、税金プロバイダー、配送をconfigure

エージェントが質問: 「org 内での B2B ストア作成は完了しましたか? 準備ができたら 'yes' と返信し、使用したストア名を教えてください。」

---

ステップ 3: ユーザーの確認を取得

エージェントが待機: ユーザーの確認とストア名

エージェントが検証: ストア名フォーマット (特殊文字なし、スペースはアンダースコアとして表示される)

エージェントが確認: 「わかりました! org で利用可能なストアフロントをリストアップします...」

---

ステップ 4: 利用可能な LWR サイトをリスト

エージェントが実行:

sf org list metadata --metadata-type DigitalExperienceConfig --json

エージェントが:

• JSON 出力を解析してサイト名を抽出
• 番号付きリストとして表示
• ネーミング (アンダースコア、数字サフィックス) を説明

出力例:

利用可能な Digital Experience サイト:
1. My_B2B_Store1
2. Partner_Portal
3. Customer_Community

---

ステップ 5: ユーザーにストアフロントを選択させる

エージェントが質問: 「どのサイトが B2B ストアに対応していますか? サイト名を選択してください:」

エージェントが検証: 選択が利用可能なサイトと一致する

エージェントが確認: 「わかりました! [site-name] のメタデータを取得します...」

---

ステップ 6: ストアフロント メタデータを取得

エージェントが実行:

sf project retrieve start -m DigitalExperienceBundle:site/<selected-store-name> --json

エージェントが:

• 取得の進捗を表示
• 成功した取得を確認
• 取得されたディレクトリ構造をリスト

期待される出力:

Retrieved: force-app/main/default/digitalExperiences/site/My_B2B_Store1/
├── My_B2B_Store1.digitalExperience-meta.xml
├── sfdc_cms__view/ (home, current_cart, detail_*, list_*, など)
├── sfdc_cms__site/
├── sfdc_cms__route/
└── [その他の sfdc_cms__* ディレクトリ]

---

ステップ 7: 次のステップを提供

エージェントが提供:

✅ メタデータが正常に取得されました!

次のステップ:

• カスタム LWC またはブランディング変更でカスタマイズ
• デプロイ: sf project deploy start --source-dir force-app/main/default/digitalExperiences/site/My_B2B_Store1/ --json

リソース: DigitalExperienceBundle ドキュメント, B2B Commerce ガイド

---

リファレンス

• store-vs-storefront.md - ストア vs ストアフロント、ソース管理、および手動作成が失敗する理由に関する技術詳細

---

記憶すること

ストアを先に作成 (ストアフロントを作成) → 取得 → カスタマイズ