既存のソースからの Salesforce DX プロジェクトの作成
Salesforce 開発者、パートナー、または ISV であれば、パッケージ化組織の管理パッケージや、Sandbox 組織または本番組織のアプリケーションソースに既存のソースがあることでしょう。Salesforce DX の使用を開始する前に、既存のソースを Salesforce DX プロジェクトに取り込みます。
-
Salesforce DX プロジェクトを作成します。
1sf project generate --name MyProject -
このプロジェクトディレクトリに移動します。
1cd MyProject -
project retrieve start コマンドを実行してソースを取得します。現在のソースの場所と形式によって、使用する必要があるコマンドフラグが決まります。
現在のソースの形式と場所 ソースを取得するコマンド パートナーであり、パッケージ化組織に管理パッケージとして定義されたソースがすでにある。 1sf project retrieve start --package-name <package-name> --target-org <sourceOrg-username-or-alias>--target-org フラグは、ソースを取得するソース組織 (パッケージング組織など) のユーザー名または別名を指定します。--package-name フラグはパッケージ名を指定します。名前にスペースが含まれる場合は、二重引用符で囲みます。
このコマンドは、デフォルトで DX プロジェクトディレクトリにパッケージと同じ名前のパッケージディレクトリを作成します。次に、パッケージからソースを取得し、標準の DX ソース形式の構造を使用して新しいディレクトリに保存します。別のディレクトリを指定するには、--output-dir を使用します。該当するディレクトリが存在しない場合には、コマンドによって作成されます。
Sandbox または本番組織のパッケージ化されていないソースを定義するマニフェストファイル (通常は package.xml という名前) がある。 1sf project retrieve start --manifest <manifest-file> --target-org <sourceOrg-username-or-alias>--target-org フラグは、ソースを取得する組織 (Sandbox や本番組織など) のユーザー名または別名を指定します。--manifest フラグはマニフェストファイル (通常は package.xml) へのパスを示します。
コマンドは、デフォルトで、DX プロジェクトの既存の force-app パッケージディレクトリにソースを取り込みます。別のディレクトリを指定するには、--output-dir を使用します。該当するディレクトリが存在しない場合には、コマンドによって作成されます。
- 取得によってプロジェクトにパッケージディレクトリが作成された場合は、そのディレクトリを sfdx-project.json ファイルに追加します。
Sandbox や本番組織にソースがあるのに、それをプロジェクトに取り込むためのマニフェストファイル (package.xml) がないということはありませんか? project generate manifest CLI コマンドを使用して、マニフェストファイルを作成します。たとえば、次のコマンドは prod-org という別名を持つ組織内のメタデータコンポーネントからマニフェストを生成します。
1sf project generate manifest --from-org prod-org詳細な例や情報については、コマンドのヘルプを参照してください。
1sf project generate manifest --helpまた、『メタデータ API 開発者ガイド』の「package.xml マニフェストファイルのサンプル」も参照してください。