--- schema_version: "1" id: 7d9e2d1412cbdba76a2f03b122dc6456a6dbcc55856ce7582ecdfd8df92c0945 title: Omnistudio Data Mapper Load Overview (Managed Package) collection: admin version: current locale: en-us portal_url: https://docs.salesforce.com/admin/current/en-us/xcloud/264-0-0/os_dataraptor_load_overview.md canonical_url: https://help.salesforce.com/s/articleView?id=xcloud.os_dataraptor_load_overview.htm&release=264.0.0&type=5 source_site: help.salesforce.com content_type: documentation content_hash: 1caf797cd51f8b09325943b573f7762880eddbdc59958b12722bbb6f87db215c description: For the managed package runtime, Data Mapper Loads accept data in JSON, XML, or custom input formats and write the data to Salesforce objects. Formulas and attributes are supported. products: - Omnistudio release: "264" --- # Omnistudio Data Mapper Load Overview (Managed Package) For the managed package runtime, Data Mapper Loads accept data in JSON, XML, or custom input formats and write the data to Salesforce objects. Formulas and attributes are supported. ![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). For example, when a user running a case-handling Omniscript finishes entering data and clicks Save, the script calls a Data Mapper Load to record the data entered. A Data Mapper Load can obtain its input data in the following ways: - Omniscript or Integration Procedure: During execution, an Omniscript or Integration Procedure builds a Data JSON that is populated with the data required for the business use case. When the script invokes the Data Mapper Load, the Data JSON is sent as input. - Interface object: Create a custom object and populate it with data for the Data Mapper Load. Use Salesforce Bulk Loader or other load tools to insert data into the object. If you must modify the data before it’s inserted into the object, define a preprocessor class. This approach lets you load data from flat files, for example. (See [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.").) Omnistudio doesn't support interface objects, but Omnistudio for Managed Packages does. - Data Mapper API REST call: If the Data Mapper is invoked using a POST action, the Data JSON can be included in the payload of the call. - Apex code: Specify the Data JSON as a parameter in the call to the Data Mapper Load. ![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 Custom objects must have unique names and shouldn't use API names that already exist for custom objects in a managed package. Custom objects are accessed in the managed package namespace and not as an object without a namespace. For example, in the vlocity\_ins\_\_ namespace, a custom object named Policy\_\_c is the same as the existing vlocity\_ins\_\_Policy\_\_c. To modify the input data, you can define formulas, transform values, and change the output data type. (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).").) To specify how the resulting data is to be written to Salesforce objects, you map fields from the output JSON to fields in Salesforce objects. (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.").) When invoked, the Data Mapper Load applies its mappings and formulas to the input data to create the output data. Then it loads the output data into Salesforce objects according to the mappings. - **[Create an Omnistudio Data Mapper Load (Managed Package)](https://help.salesforce.com/s/articleView?id=xcloud.os_create_a_dataraptor_load.htm&release=264.0.0&type=5)** For the managed package runtime, to create a Data Mapper Load, specify its name, input and output types, permissions, and options. - **[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. - **[Multiple Related Object Loads (Link Mappings) (Managed Package)](https://help.salesforce.com/s/articleView?id=xcloud.os_multiple_related_object_loadslink_mappings.htm&release=264.0.0&type=5)** For the managed package runtime, when loading data into a sequence of objects, you can propagate data directly from one object to another related object. For example, you can use an Omnistudio Data Mapper Load to support an Omniscript that creates an Account and a Contact for the Account. - **[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. - **[Test an Omnistudio Data Mapper Load (Managed Package)](https://help.salesforce.com/s/articleView?id=xcloud.os_test_a_dataraptor_load.htm&release=264.0.0&type=5)** For the managed package runtime, you can test the results of a Data Mapper Load on the Preview tab. - **[Omnistudio Data Mapper Load Examples (Managed Package)](https://help.salesforce.com/s/articleView?id=xcloud.os_dataraptor_load_examples.htm&release=264.0.0&type=5)** For the managed package runtime, Data Mapper Load examples demonstrate formulas and object relationships, and working with attributes.