スクラッチ組織定義ファイル

スクラッチ組織に関連付けられている次のような設定および設定オプションにより、そのシェイプが決まります。

• エディション — スクラッチ組織の Salesforce エディション (Developer、Enterprise、Group、Professional など)。
• アドオン機能 — デフォルトではエディションに含まれない機能 (マルチ通貨など)。
• 設定 — Salesforce 製品の設定に使用される組織と機能の設定 (Chatter やコミュニティなど)。

異なるスクラッチ組織定義ファイルを設定すると、テスト用に異なるシェイプを持つスクラッチ組織を簡単に作成できます。たとえば、定義ファイルに ChatterEnabled 組織設定を指定することで、スクラッチ組織の Chatter を有効または無効にできます。以前のようにサンプルデータとメタデータを含むスクラッチ組織が必要な場合、hasSampleData オプションを追加します。

スクラッチ組織定義ファイルには次のオプションを指定できます。

1{
2  "orgName": "Acme",
3  "edition": "Enterprise",
4  "features": ["Communities", "ServiceCloud", "Chatbot"],
5  "settings": {
6      "orgPreferenceSettings": {
7          "networksEnabled": true,
8          "s1DesktopEnabled": true,
9          "s1EncryptedStoragePref2": false
10      },
11      "omniChannelSettings": {
12          "enableOmniChannel": true
13      },
14
15      "caseSettings": {
16          "systemUserEmail": "support@acme.com"
17      }
18  }
19}

コミュニティなど、機能によっては、スクラッチ組織で適切に機能するために機能と設定の組み合わせが必要になることがあります。次のコードスニペットでは、機能と関連付けられた設定の両方が設定されます。

1"features": ["Communities"],
2    "settings": {
3        ""networksEnabled": true
4        ...

force:org:create CLI コマンドでスクラッチ組織を作成するときには、スクラッチ組織設定ファイルへのパスを指定します。このファイルには任意の名前を指定でき、CLI がアクセスできる任意の場所に配置できます。

サンプルリポジトリを使用する場合や Salesforce DX プロジェクトを作成する場合、サンプルのスクラッチ組織定義ファイルは config ディレクトリにあります。異なる組織シェイプやテストシナリオ用に異なる組織設定ファイルを作成できます。識別しやすいように、ファイルには���かりやすい名前を付けます (たとえば、devEdition-scratch-def.json や packaging-org-scratch-def.json など) 。

このファイルをプロジェクトで保持し、バージョン管理システムにチェックインすることをお勧めします。たとえば、すべてのチームメンバーが使用できるように、チームバージョンを作成してチェックインします。個々の開発者も、スクラッチ組織定義パラメータを含む自分のローカルバージョンを作成できます。これらのパラメータとして、スクラッチ組織の作成者を識別するメールや姓などがあります。