---
schema_version: "1"
id: 90f326e536680dfeab51f68ebe94a2e5fe749264831802e7d7b6c102d6e8d944
title: Create an Omnistudio Data Mapper Load (Managed Package)
collection: admin
version: current
locale: en-us
portal_url: https://docs.salesforce.com/admin/current/en-us/xcloud/264-0-0/os_create_a_dataraptor_load.md
canonical_url: https://help.salesforce.com/s/articleView?id=xcloud.os_create_a_dataraptor_load.htm&release=264.0.0&type=5
source_site: help.salesforce.com
content_type: documentation
content_hash: 78642ae881fa58219f46b2ec11edbef15f01f82a86b3d37cefd89754dbd78cc8
description: For the managed package runtime, to create a Data Mapper Load, specify its name, input and output types, permissions, and options.
products:
  - Omnistudio
release: "264"
---
# Create an Omnistudio Data Mapper Load (Managed Package)

For the managed package runtime, to create a Data Mapper Load, specify its name, input and output types, permissions, and options.

![Managed Package app icon](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-xcloud-omnistudio_for_managed_packages-264-0-0-production-enus/aa2554ec-624a-4ee6-8da4-6435670e6e62/resources-global/_corporate/images/managedpackageicon.png) This information is for Omnistudio for Managed Packages. For Omnistudio on standard runtime, see [Omnistudio Help](https://help.salesforce.com/s/articleView?id=xcloud.os_omnistudio_standard.htm&language=en_US).

1. Go to the Data Mapper Designer tab.
2. Click **New**.
3. On the Create dialog, specify the following settings, and click **Save**:
    
    - Data Mapper Interface Name — Descriptive name of your choice
    - Batch Size — Number of records processed per batch transaction, between 1 and 2000
    - Interface Type — Load
    - Input Type — Choose JSON, XML SObject, or Custom. If your Data Mapper load is called from an Omniscript, choose JSON. If you choose sObject, select the interface object for the input data from the dropdown list. (More information: [Interface Objects for External Data Loads (Managed Package)](https://help.salesforce.com/s/articleView?id=xcloud.os_interface_objects_for_external_data_loads.htm&release=264.0.0&type=5 "For the managed package runtime, to provide data from an external source (for example, a CSV file) to an Omnistudio Data Mapper, create an interface object and optionally a preprocessor class. Interface objects are custom Salesforce objects."). For details about custom data serialization, see [Custom Input and Output for Omnistudio Data Mappers in Omnistudio for Managed Packages (Managed Package)](https://help.salesforce.com/s/articleView?id=xcloud.os_custom_input_and_output_for_dataraptors_in_omnistudio_for_vlocity.htm&release=264.0.0&type=5 "For the managed package runtime, by default, Data Mappers handle JSON and XML data. To handle other data formats, you can configure a Data Mapper to use a custom input or output that you implement is a custom class. For example, you can define a Data Mapper Transform that accepts CSV-formatted data and outputs it as JSON.").)
        
        ![Note](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-xcloud-omnistudio_for_managed_packages-264-0-0-production-enus/aa2554ec-624a-4ee6-8da4-6435670e6e62/images/icon_note.png)
        
        Note
        
        SObject input isn't supported in Summer '21 and later releases.
    - Output Type — SObject
    - Required Permission — If specified, this setting limits who can run this Integration Procedure. Specify a comma-separated list of custom permission names.
4. On the Objects tab, specify the Salesforce objects that you want to update.
    
    The FeedComment and IdeaComment objects aren't selectable.
5. On the Formulas tab, define any transformations you want to apply to the input data to add data to the output data. For details about the functions that you can use in formulas to define transformations, see [Use Formulas in Omnistudio Data Mappers (Managed Package)](https://help.salesforce.com/s/articleView?id=xcloud.os_use_formulas_in_dataraptors.htm&release=264.0.0&type=5 "For the managed package runtime, to add data to the output of a Data Mapper, define formulas. Several types of Data Mapper (Extract, Transform, and Load) support formulas. When you define a formula, you map its output to the output JSON (for extracts and transforms) or Salesforce object field (for loads).").
6. On the Fields tab, map the input data to the Salesforce object fields that you want to update. For more information, see [Object Field Mapping (Managed Package)](https://help.salesforce.com/s/articleView?id=xcloud.os_object_field_mapping.htm&release=264.0.0&type=5 "For the managed package runtime, on the Fields tab, you map data from the Omnistudio Data Mapper Load input JSON to the target Salesforce object and field. You can also handle data types, attributes, and default values.").
7. On the Options tab are optional properties you can set.
    
    The following options are available only if the Input Type is SObject:
    
    - Batch Size — The number of records processed per batch transaction, between 1 and 2000.
    - Process Now Threshold — The number of records processed immediately, between 0 and 199.
    - Preprocessor Class Name — The adapter Apex class that implements the IDRPreprocess Apex interface.
    - Delete on Success — Automatically delete bulk records after successfully bulk-loading data.
    - Process Super Bulk — Process large jobs spread over multiple Salesforce Apex batch jobs without exceeding Salesforce governor limits.
    - Is Default for Interface — Specify this Data Mapper as the default bundle for the specified interface object.
    
    The following options are available for all Data Mapper Loads:
    
    - Ignore Errors — Execute the Data Mapper even if errors occur, skipping only the steps having errors. This option is useful when you know a record will fail with limited data and future steps don't rely on previous steps.
    - Rollback on Error — Don't create or update the sObjects if errors occur. For more information, see [Apex Transactions](https://developer.salesforce.com/docs/atlas.en-us.apexcode.meta/apexcode/apex_transaction.htm) and [Transaction Control](https://developer.salesforce.com/docs/atlas.en-us.apexcode.meta/apexcode/langCon_apex_transaction_control.htm) in the Salesforce documentation.
    - Use Assignment Rules — Use assignment rules for sObjects such as Cases that have user assignment fields. For more information, see [Set Up Assignment Rules](https://help.salesforce.com/articleView?id=creating_assignment_rules.htm&type=5&language=en_US) in the Salesforce documentation.
        
        In Summer '19 and later releases, if emails are configured in Case assignment rules, checking this option automatically sends emails to users when Cases are assigned.
    - Overwrite Target For All Null Inputs — If an input doesn't have a value, set the corresponding output value to NULL.

What’s next: [Object Field Mapping (Managed Package)](https://help.salesforce.com/s/articleView?id=xcloud.os_object_field_mapping.htm&release=264.0.0&type=5 "For the managed package runtime, on the Fields tab, you map data from the Omnistudio Data Mapper Load input JSON to the target Salesforce object and field. You can also handle data types, attributes, and default values.").