mcpField
C
commerce-b2b-store-create

commerce-b2b-store-create

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

commerce-b2b-store-create について

Salesforce で Commerce B2B Store を作成し、自動生成された storefront メタデータを取得するためのスキルです。確認とサイト選択を経て取得する、対話型の 7 段階フローを案内します。

主な機能

  1. 01対話型の 7 段階フロー
  2. 02org での Store 作成が先行条件
  3. 03サイト一覧からユーザーが選択
  4. 04Salesforce CLI の JSON 出力でメタデータを取得

活用シーン

  1. 01Commerce B2B Store の作成
  2. 02生成された storefront メタデータの取得
  3. 03org 内で対応するサイトを選択
  4. 04storefront のカスタマイズとデプロイを準備

インストール

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

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

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

同梱ファイル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 Docs、B2B Commerce Guide

参考資料

  • store-vs-storefront.md - Store と Storefront の違い、ソース管理、手動での作成が失敗する理由に関する技術的な詳細

覚えておきましょう

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

コメント

Markdown 対応