--- schema_version: "1" id: e8965bea4756a2eacef5391676fc3595c21f09869f42d64033ffaf531e8ed56f title: Omnistudio Data Mapper Transform Data Mappings (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_transform_data_mappings.md canonical_url: https://help.salesforce.com/s/articleView?id=xcloud.os_dataraptor_transform_data_mappings.htm&release=264.0.0&type=5 source_site: help.salesforce.com content_type: documentation content_hash: 5540f7bb959873741f3b9402205d8a515b09fad937856bdcb97baac377b90ff9 description: For the managed package runtime, to map data from the input to the output, go to the Output tab. You can also handle null values, data types, caching, and list transforms. products: - Omnistudio release: "264" --- # Omnistudio Data Mapper Transform Data Mappings (Managed Package) For the managed package runtime, to map data from the input to the output, go to the Output tab. You can also handle null values, data types, caching, and list transforms. ![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). You can map data on the Transforms tab in one of two ways: - If the input and output names match, [Use Quick Match to Map Data (Managed Package)](https://help.salesforce.com/s/articleView?id=xcloud.os_use_quick_match_to_map_data.htm&release=264.0.0&type=5 "For the managed package runtime, quick Match is a handy way to map input and output data in an Omnistudio Data Mapper Transform when the names match."). - Specify each mapping individually. Both ways apply to JSON input and output and to other input and output types. To specify individual mappings: 1. Click +. An empty mapping is added to the list. 2. In the Input JSON Path field, specify the input path. 3. In the Output JSON Path field, specify the desired output path. Use colons to separate path levels, for example `Contact:LastName`. ## Data Restructuring and Renaming All types of Data Mappers can restructure data and rename fields using mappings. To restructure and/or rename a field, you map the input path to the desired output path. The following example shows JSON input being mapped to XML output. The incoming top-level Case fields, CaseNumber, AccountId, and AccountName, are reparented under an XML element named . Although the list of contacts is unchanged, note the difference between the representation of a list in JSON and in XML. In JSON, the Contacts list is enclosed in square brackets, \[\], then each item in the Contacts list is enclosed in brackets, {}. In XML, each item in the Contacts list is enclosed in a element. For details about converting between JSON and XML, see [XML in Omnistudio Data Mappers (Managed Package)](https://help.salesforce.com/s/articleView?id=xcloud.os_xml_in_dataraptors.htm&release=264.0.0&type=5 "For the managed package runtime, in addition to JSON, Data Mappers can have XML input and output. The XML format in Data Mappers is an unordered key/value, JSON-like structure."). ![Figure is explained in the preceding text.](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-xcloud-omnistudio_for_managed_packages-264-0-0-production-enus/aa2554ec-624a-4ee6-8da4-6435670e6e62/omnistudio_for_managed_packages/images/transforming_data_using_dataraptor.png) For the PDF, DocuSign, and Document Template output types, output mappings are generated based on the fields in the Target Output file you selected when you created the Data Mapper Transform. By default, if a value is null, no node is created for the field in the output JSON. To ensure that a node is created, regardless of whether the field is null, go to the Options tab and check Overwrite Target For All Null Inputs. ## Input Value to Output Value Mappings To verify that your mappings create the desired structure, go to the Preview tab, paste sample input into the Input pane on the left side of the screen, and click Execute. The results are displayed in the Response pane. To replace one value with another, open the mapping and create entries in the Transform Map Values list. For example, if the incoming field contains TRUE or FALSE and your Omniscript requires a Y or N value, create the following entries: ![Under Transform Map Values, a Key of TRUE is mapped to a Value of Y and a Key of FALSE is mapped to a Value of N.](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-xcloud-omnistudio_for_managed_packages-264-0-0-production-enus/aa2554ec-624a-4ee6-8da4-6435670e6e62/omnistudio_for_managed_packages/images/transforming_data_using_dataraptor_1.png) ## Output Data Types On the Output tab, you can specify the data type of the output data. If you change the type, be sure to choose a compatible output type. (For example, changing a numeric type to a string is fine, but changing a string to a numeric is risky, because a string can contain non-numeric characters.) See [Omnistudio Data Mapper Output Data Types (Managed Package)](https://help.salesforce.com/s/articleView?id=xcloud.os_dataraptor_output_data_types.htm&release=264.0.0&type=5 "For the managed package runtime, many data types can be assigned to data in the Output JSON, including boolean, currency, string, various number and list types, and date formats."). ## Data Caching You can configure optional caching settings on the Options tab: - **Time To Live In Minutes**: If data caching is enabled, determines how long data remains in the cache. The minimum value is 5. - **Salesforce Platform Cache Type**: Enables data caching. Set to **Session Cache** for data related to users and their login sessions, or to **Org Cache** for all other types of data. See [Cache for Omnistudio Data Mappers (Managed Package)](https://help.salesforce.com/s/articleView?id=xcloud.os_cache_for_dataraptors_and_integration_procedures.htm&release=264.0.0&type=5 "For the managed package runtime, Omnistudio offers multiple caching options to improve performance and minimize unnecessary data processing in Data Mappers. The two primary user-configurable caching types are Org Cache and Session Cache, which are available in the Data Mapper designer. These caching mechanisms are part of the Salesforce Platform Cache and are implemented through Vlocity Cache in Omnistudio with managed package runtime. Each serves a distinct purpose and comes with specific configuration considerations."). ## What’s Next