project convert source
Convert source-formatted files into metadata that you can deploy using Metadata API.
To convert source-formatted files into the metadata format, so that you can deploy them using Metadata API, run this command. Then deploy the metadata using “sf project deploy”.
To convert Metadata API–formatted files into the source format, run “sf project convert mdapi”.
To specify a package name that includes spaces, enclose the name in single quotes.
To convert multiple components, either set multiple –metadata <name> flags or a single –metadata flag with multiple names separated by spaces. Enclose names that contain spaces in one set of double quotes. The same syntax applies to –source-dir.
force:source:convert
| Flag Name (Long) | Flag Name (Short) | Description |
|---|---|---|
‑‑api‑version | N/A | Type: Value API Version to use in the generated project’s manifest. By default, will use the version from sfdx-project.json Override the api version used for api requests made by this command |
‑‑flags‑dir | N/A | Type: Value Import flag values from a directory. |
‑‑json | N/A | Type: Boolean Format output as json. |
‑‑manifest | ‑x | Type: Value Path to the manifest (package.xml) file that specifies the metadata types to convert. If you specify this flag, don’t specify –metadata or –source-dir. |
‑‑metadata | ‑m | Type: Value Metadata component names to convert. |
‑‑output‑dir | ‑d | Type: Value Default value: metadataPackage_1781107861598Output directory to store the Metadata API–formatted files in. |
‑‑package‑name | ‑n | Type: Value Name of the package to associate with the metadata-formatted files. |
‑‑root‑dir | ‑r | Type: Value Source directory other than the default package to convert. |
‑‑source‑dir | ‑p | Type: Value Paths to the local source files to convert. The supplied paths can be to a single file (in which case the operation is applied to only one file) or to a folder (in which case the operation is applied to all metadata types in the directory and its sub-directories). If you specify this flag, don’t specify –manifest or –metadata. |
Convert source-formatted files in the specified directory into metadata-formatted files; writes converted files into a new directory:
Similar to previous example, but writes converted files to the specified output directory and associates the files with the specified package: