mcpField
C
creating-b2b-commerce-store

creating-b2b-commerce-store

github.com/forcedotcom開発1.1k3.3k 回インストール1 日前に更新
リポジトリ

creating-b2b-commerce-store について

Salesforce で B2B Commerce のストアを作成し、自動生成されたストアフロントのメタデータを取得する対話型スキルです。ストアを先に作成し、一覧からサイトを選んで取得する手順を求め、メタデータの手動作成は行いません。

主な機能

  1. 01B2B Commerce Store 作成の案内
  2. 02利用可能な Digital Experience サイトの一覧表示
  3. 03選択したストアフロントサイトの確認
  4. 04生成済みストアフロントメタデータの取得
  5. 05カスタマイズとデプロイ手順の提示

活用シーン

  1. 01組織での B2B Commerce ストア作成
  2. 02サイト一覧から対応するサイトを選択
  3. 03プロジェクトへのストアフロントメタデータ取得
  4. 04取得したストアフロントのカスタマイズやデプロイ準備

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/forcedotcom/sf-skills --skill creating-b2b-commerce-store

インストール後、Claude Code で/creating-b2b-commerce-storeを入力して読み込まれたか確認します。

同梱ファイルreferences/store-vs-storefront.md

詳細

Commerce B2B ストアフロントの作成

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

重要な概念

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

ストアとストアフロントのリファレンスを参照してください。

このスキルを使用するタイミング

ユーザーから次のようなリクエストがあった場合に起動します。

  • 「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 はストア（データ）＋ストアフロント（メタデータ）で構成されます。まずストアを作成する必要があります。

ストアとストアフロントのリファレンスを参照してください。

手順 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. 任意：決済ゲートウェイ、税務プロバイダー、配送を設定します。

続いてエージェントが尋ねます。 「組織内で B2B ストアの作成は完了しましたか？準備ができたら「yes」と返信し、使用したストア名を教えてください。」

手順 3：ユーザーの確認を得る

エージェントが待つ内容： ユーザーの確認とストア名

エージェントが検証する内容： ストア名の形式（特殊文字がなく、スペースはアンダースコアとして表示されます）

エージェントが確認する内容： 「ありがとうございます。組織内で利用可能なストアフロントを一覧表示します……」

手順 4：利用可能な LWR サイトを一覧表示する

エージェントが実行します。

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

エージェントが行うこと：

  • JSON 出力を解析してサイト名を抽出する
  • 番号付きリストとして表示する
  • 命名規則（アンダースコア、数字の接尾辞）を説明する

出力例：

Available Digital Experience sites:
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_*, etc.)
├── sfdc_cms__site/
├── sfdc_cms__route/
└── [other sfdc_cms__* directories]
手順 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 - Store と Storefront の違い、ソース管理、手動での作成が失敗する理由に関する技術的な詳細

覚えておきましょう

まず Store（Storefront を作成）→ 取得 → カスタマイズ

コメント

Markdown 対応