Salesforce DX 開発者ガイド
jプロジェクトと組織の間での変更の追跡
| ソース追跡を有効にできるのは、Developer Sandbox と Developer Pro Sandbox のみです。 |
| スクラッチ組織のソース追跡が使用可能なエディション: Professional Edition、Enterprise Edition、Performance Edition、Unlimited Edition、Database.com Edition、および Developer Edition |
| 必要なユーザ権限 | |
|---|---|
| プロジェクトと Sandbox の間の変更を追跡する | 「Sandbox の管理」 |
| Sandbox のソース追跡を有効にする | 「アプリケーションのカスタマイズ」 |
- メタデータコンポーネントへの変更を自動的に追跡し、手動で追跡する手間を省く。
- 他の開発者によって Sandbox にプッシュされた変更を参照する。
- 変更されたソースをプッシュまたはプルする。
- ソースをプッシュまたはプルする前に、ローカルプロジェクトとスクラッチ組織または Sandbox 間の競合を特定して解決する。
ソース追跡をサポートするメタデータコンポーネントを確認するには、「Metadata Coverage Report (メタデータカバー率レポート)」の「ソース追跡」列を調べてください。
- Salesforce CLI をインストールする。
- Dev Hub を有効にする。
- Sandbox のソース追跡を有効にする。
- DX プロジェクトを作成する。
- スクラッチ組織または Sandbox を作成する、あるいは、Sandbox のソース追跡を有効にす���前に、作成した Sandbox を更新する。
CLI コマンドがソース追跡をサポートする方法
ソース追跡はすべての force:source:* コマンドでサポートされますが、各コマンドの使用方法には違いがあります。
force:source:push|pull コマンドは、変更されたすべてのソースをローカルプロジェクトと対象組織間でプッシュまたはプルします。重要な点はすべてということです。特定のソースファイルを選択してプッシュまたはプルすることはできません。変更されたすべてのファイルがコマンドの対象になります。
一方、force:source:deploy|retrieve コマンドは、きめ細かな制御が可能です。適切なパラメータを指定することにより、特定のメタデータコンポーネント、パッケージディレクトリ、またはマニフェストファイルをリリースしたり、取得したりできます。ソース追跡ファイルが更新されたことを確認するには、--tracksource パラメータを指定する必要があります。この例では、MyFabClass Apex クラスを取得します。
1sfdx force:source:retrieve --metadata ApexClass:MyFabClass --tracksource通常は、特定の変更を 1 つずつ反映するのではなく、force:source:push|pull を使用して、ローカルプロジェクトと組織間のすべての変更をまとめて反映することをお勧めします。すべての変更を一度にプッシュまたはプルすると、追跡ファイルが現在の状態を正確に反映するようになります。こうした理由から、ソース追跡に関するトピックの例では、force:source:deploy|retrieve ではなく force:source:push|pull を使用しています。