---
schema_version: "1"
id: ddd5766699502e72ed133938924335585b64fa59f33bf02b7b6bab89457c26f4
title: Inputs and Outputs for Omnistudio Data Mappers
collection: admin
version: current
locale: en-us
portal_url: https://docs.salesforce.com/admin/current/en-us/xcloud/264-0-0/os_inputs_outputs_for_data_mappers.md
canonical_url: https://help.salesforce.com/s/articleView?id=xcloud.os_inputs_outputs_for_data_mappers.htm&release=264.0.0&type=5
source_site: help.salesforce.com
content_type: documentation
content_hash: 9141bd0c7a9a99c3118d972190b95db7f1ad7cba09f996bf3ee0a1164ef954c5
description: The configuration of inputs and outputs in Salesforce Omnistudio Data Mappers is highly flexible. The primary data formats are JSON and XML with other options available.
products:
  - Omnistudio
release: "264"
---
# Inputs and Outputs for Omnistudio Data Mappers

The configuration of inputs and outputs in Salesforce Omnistudio Data Mappers is highly flexible. The primary data formats are JSON and XML with other options available.

JSON is the native and most common format used throughout Omnistudio components. Data Mappers (Extract, Load, Transform) accept JSON payloads passed from Integration Procedures, OmniScripts, or external REST API calls. JSON is also the default and most common format for Extract and Transform Data Mappers, which other Omnistudio components or external REST clients consume.

Use XML for integration with legacy or enterprise systems that rely on XML-based messaging. Load and Transform Data Mappers can accept XML payloads, which is useful for handling responses from callouts made within an Integration Procedure. If you use XML output for Extract and Transform Data Mappers, Omnistudio can send data to external XML-dependent systems.

For highly non-standard data structures that JSON or XML can’t handle, Data Mappers offer custom input (for Load and Transform) and output (for Extract and Transform) as an option through Apex.

Finally, because a Data Mapper Transform’s purpose is to manipulate data, it can convert data into formats for document generation. A Transform converts structured JSON into the format to create a PDF. Transforms also structure data to populate fields in a DocuSign envelope or another document template.

- **[Omnistudio Data Mapper Output Data Types](https://help.salesforce.com/s/articleView?id=xcloud.os_dataraptor_output_data_types_47661.htm&release=264.0.0&type=5)**  
    Many data types can be assigned to data in the Output JSON, including boolean, currency, string, various number and list types, and date formats.
- **[XML and JSON in Omnistudio Data Mappers](https://help.salesforce.com/s/articleView?id=xcloud.os_xml_in_dataraptors_46723.htm&release=264.0.0&type=5)**  
    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.
- **[Custom Input and Output for Omnistudio Data Mappers in Omnistudio](https://help.salesforce.com/s/articleView?id=xcloud.os_custom_input_and_output_for_dataraptors_in_omnistudio_47987.htm&release=264.0.0&type=5)**  
    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.