SFDC：DreamHouseアプリケーションを使ったスクラッチ組織の環境構築を試してみました

事前準備

Dev Hub組織を用意します。Developer Edtion組織またはTrailheadのハンズオン組織で問題ありません。設定からDevhub組織の有効化を行えば準備完了です。

GitHubからプロジェクトのダウンロード

Trailheadの手順で進めます。

git clone コマンドでdreamhose-lwcリポジトリをコピーします。git cloneのあとはcdコマンドで作成したdreamhouse-lwcディレクトリに移動します。

プロジェクトのブランチを作成

ターミナルからgit コマンドを実行してブランチを作成します。

// git clone直後は mainのみ表示される。
git branch

// このコマンドでブランチ作成と作成したブランチに切り替えを実行
git checkout -b my_branch

// ブランチが切り替わっていることを確認
git branch

DevHev組織の認証設定

ログインコマンド

sf org login web -a DevHub -d -b chrome

ログインするとこのような感じで認証とtarget-dev-hubのセットができます。

スクラッチ組織の作成

SalesforceCLIでDevHub組織の認証ができていればスクラッチ組織作成コマンドで組織を作成できます。

sf org create scratch -d -f config/project-scratch-def.json -a dreamhouse-org

作成処理は短時間で完了します。

作成コマンドの「-f config/project-scratch-def.json」はスクラッチ組織作成の定義ファイルを参照しています。DreamHouseではこのように宣言していました。

作成したスクラッチ組織は open コマンドでアクセスできます。

• o で対象組織を指定できます。 -b で表示ブラウザを指定できます。

sf org open -o dreamhouse-org -b chrome

スクラッチ組織にソースをデプロイ

dreamhouseアプリケーションをスクラッチ組織にデプロイします。ソース一式はforce-appフォルダの中で確認できますが、関連するオブジェクトやレイアウト、タブなどのメタデータも格納されている状態となっていました。

デプロイコマンドは次の内容を実行します。

sf project deploy start

実行してみるとすごく簡単にデプロイが成功しました。「sf project deploy start」コマンドは実行時に対象ソースを指定したりマニフェストファイルを指定したりとフラグ設定が可能ですが、全部が対象のときにはフラグ未設定でそのまま実行すればよかったです。(ちなみにdreamhouse-lwcにはpackage.xmlは含まれていませんでした。)

メッセージどおりにデプロイできているかはスクラッチ組織にアクセスすると確認できます。

権限セットの割り当て

スクラッチ組織にDreamHouseをデプロイできたら権限セットの割り当て操作も試すことができます。

次の書き方でDreamHouseという権限セットをスクラッチ組織の管理者ユーザに割り当てることができます。

sf org assign permset -n Dreamhouse

テストデータのインポート

スクラッチ組織でDreamhouseアプリケーションを動かしてみる際に必要なテストデータのインポートも簡単に実施できます。

「sf data import tree」コマンドを使用します。-p はインポート対象のファイルのパスです。

sf data import tree -p data/sample-data-plan.json

コマンド実行が成功したあとスクラッチ組織で対象オブジェクトを見てみるとテストデータが正常に登録されていました。

DreamHouseアプリケーションを動かしてみる

アプリケーションランチャーでDreamhouseを選択。『Property Explorer』『Property Finder』がLightningコンポーネントで作られたアプリケーションです。

参考 - Salesforce DX の用語