You are here:
Export or Import an Omnistudio Data Mapper
Export or import Data Mappers to use them in another org, such as when you create them in a sandbox. When exporting or importing data packs for Data Mappers, if you encounter Apex limit errors such as heap or CPU limits, reduce the size of the data pack by unselecting dependencies during the export process. Additionally, break the data pack into multiple smaller data packs. As a best practice, we recommend including no more than 10 elements in each data pack.
Export a Data Mapper
You can export a Data Mapper from the new designer with the Salesforce CLI.
Before you begin,Set Up Salesforce CLI
-
From a terminal in VS Code, enter this command, and replace the listed variables with
the appropriate values.
sf data export tree --query "SELECT Id, SourceObject,ExpectedInputOtherData,ExpectedOutputJson,Description,ExpectedOutputXml,IsDeletedOnSuccess,IsProcessSuperBulk,OverrideKey,PreviewOtherData,SynchronousProcessThreshold,TargetOutputDocumentIdentifier,GlobalKey,Name,IsAssignmentRulesUsed,IsXmlDeclarationRemoved,XmlOutputTagsOrder,IsSourceObjectDefault,InputParsingClass,ExpectedOutputOtherData,PreviewSourceObjectData,OutputType,PreviewJsonData,IsRollbackOnError,BatchSize,ResponseCacheType,IsNullInputsIncludedInOutput,VersionNumber,OutputParsingClass,Type,IsErrorIgnored,ExpectedInputJson,ExpectedInputXml,RequiredPermission,PreviewXmlData,InputType,ResponseCacheTtlMinutes,TargetOutputFileName,IsFieldLevelSecurityEnabled,PreprocessorClassName, (SELECT Id,MigrationPattern,InputObjectQuerySequence,FormulaResultPath,FormulaSequence,LinkedFieldName,IsDisabled,MigrationCategory,MigrationType,OutputFieldName,MigrationValue,FilterGroup,LinkedObjectSequence,GlobalKey,Name,OutputCreationSequence,DefaultValue,LookupReturnedFieldName,IsRequiredForUpsert,MigrationProcess,FilterDataType,InputObjectName,FormulaExpression,LookupObjectName,MigrationAttribute,MigrationGroup,FilterValue,FilterOperator,InputFieldName,MigrationKey,IsUpsertKey,LookupByFieldName,OutputFieldFormat,TransformValueMappings,OutputObjectName FROM OmniDataTransformItems) FROM OmniDataTransform WHERE Id='data_mapper_id'" --target-org org_alias --plan --output-dir export_directory - Verify whether the file in JSON format is downloaded in the directory.
- Run the import command.
Import a Data Mapper
You can import a Data Mapper from the new designer with the Salesforce CLI.
Before you begin, Set Up Salesforce CLI.
Export a Data Mapper with Designer on a Managed Package
If you're using the designer on a managed package, you can export a Data Mapper from the Data Mapper Home page.
- From the App Launcher, find and select Omnistudio Data Mappers.
- Select the version of the Data Mapper that you want to export.
-
Click
.
- Select the item to export, and click Next.
- Review the item to export, and click Next.
- If needed, update the name and description.
- To store the data pack and access it later from the Omnistudio DataPacks tab, select Add to Library.
- To download the data pack to your computer, select Download.
- Click Done.
Import a Data Mapper with Designer on a Managed Package
If you're using the designer on a managed package, you can import a Data Mapper from the Data Mapper Home page.
- From the App Launcher, find and select Omnistudio Data Mappers.
- Click Import.
- Click Browse, select a data pack from your computer that you want to upload, and click Open.
- Click Next.
- Select the item to import, and click Next.
- Review the item to import.
- Click Next and then Done.

