Salesforce DX 開発者ガイド
jスクラッチ組織の作成
スクラッチ組織定義ファイルを作成したら、コマンドラインから直接、簡単にスクラッチ組織を作成し、開くことができます。
スクラッチ組織を作成する前に、次の操作を実行します。
- Salesforce DX プロジェクトを設定する
- Dev Hub 組織を認証する
- スクラッチ組織定義ファイルを作成する
機能開発用、名前空間が含まれるパッケージの開発用、ユーザ受け入れテスト用など、さまざまな機能用のスクラッチ組織を作成できます。
-
スクラッチ組織を作成します。
目的 実行するコマンド スクラッチ組織定義ファイルを使用して開発用のスクラッチ組織を作成する スクラッチ組織定義ファイルには、組織のエディション、機能、組織設定、およびその他のオプションを定義します。 1sfdx force:org:create -f project-scratch-def.jsonコマンドラインで key=value ペアを使用してスクラッチ組織定義値を指定する 1sfdx force:org:create adminEmail=me@email.com edition=Developer \ 2 username=admin_user@orgname.org別名を持つスクラッチ組織を作成する スクラッチ組織のユーザ名は長く、直観的に理解できません。各スクラッチ組織の作成時に別名を設定すると、スクラッチ組織の機能を追跡しやすくなります。しかも、その後で CLI コマンドを発行するとき、はるかに思い出しやすくなります。 1sfdx force:org:create -f project-scratch-def.json -a MyScratchOrgユーザ受け入れテスト用またはパッケージのインストールのテスト用にスクラッチ組織を作成する この場合、名前空間を持つスクラッチを作成する必要はありません。次のコマンドを使用して、スクラッチ組織定義ファイルの名前空間値を上書きできます。 1sfdx force:org:create -f project-scratch-def.json --nonamespaceこのスクラッチ組織がデフォルトであると示す プロジェクト内から実行される CLI コマンドでは、デフォルトのスクラッチ組織が使用され、毎回ユーザ名とパラメータを手動で入力する必要がありません。 1sfdx force:org:create -f project-scratch-def.json --setdefaultusernameスクラッチ組織の期間、つまりスクラッチ組織の有効期限がいつ切れるかを指定する (日数) デフォルトは 7 日です。有効な値は 1 ～ 30 です。 1sfdx force:org:create -f config/project-scratch-def.json --durationdays 301sfdx force:org:create -f config/project-scratch-def.json -d 3スクラッチ組織の Salesforce リリースを指定する Salesforce リリースの移行中、スクラッチ組織を作成するときにリリース (プレビューまたは以前) を指定できます。「スクラッチ組織の Salesforce リリースの選択」を参照してください。 現在のディレクトリに対するスクラッチ定義ファイルへの相対パスを示します。サンプルリポジトリの場合、このファイルは config ディレクトリにあります。
stdout に 2 つの重要な情報 (組織 ID とユーザ名) が表示されます。
1Successfully created scratch org: 00D3D0000000PE5UAM, 2 username: test-b4agup43oxmu@example.comスクラッチ組織が作成される前に create コマンドがタイムアウトした場合 (デフォルトの待機時間は 6 分)、エラーが表示されます。スクラッチ組織 ID が返されるかどうかを確認するには次のコマンドを発行します。これにより、スクラッチ組織の存在が確認されます。
1sfdx force:data:soql:query -q "SELECT ID, Name, Status FROM ScratchOrgInfo \ 2 WHERE CreatedBy.Name = '<your name>' \ 3 AND CreatedDate = TODAY" -u <Dev Hub org>次の例では、名前を Jane Doe とし、Dev Hub 組織の別名 DevHub が作成されています。
1sfdx force:data:soql:query -q "SELECT ID, Name, Status FROM ScratchOrgInfo \ 2 WHERE CreatedBy.Name = 'Jane Doe' AND CreatedDate = TODAY" -u DevHub正常に機能しない場合は、--wait パラメータを使用してより長いタイムアウト値を持つ別のスクラッチ組織を作成します。正常に機能しないスクラッチ組織を必ず削除します。
-
組織を開きます。
1sfdx force:org:open -u <username/alias>Lightning Experience でスクラッチ組織を開くか、Visualforce ページを開く場合、--path パラメータを使用します。1sfdx force:org:open --path lightning - ローカルプロジェクトのソースをスクラッチ組織に転送します。