---
schema_version: "1"
id: d510517cc759d9a9d77959a09e3da704047b6de19923b812e946aec958450e77
title: Omnistudio Data Mapper Transform Examples
collection: admin
version: current
locale: en-us
portal_url: https://docs.salesforce.com/admin/current/en-us/xcloud/264-0-0/os_dataraptor_transform_examples_46793.md
canonical_url: https://help.salesforce.com/s/articleView?id=xcloud.os_dataraptor_transform_examples_46793.htm&release=264.0.0&type=5
source_site: help.salesforce.com
content_type: documentation
content_hash: 665233127e81761ee8ca7f4badac7cf1ce5e8d3770b1f6fbc947624d5331b7ae
description: Data Mapper Transform examples demonstrate how to convert a single item into a list with one item and how to convert a list of objects to a list of values.
products:
  - Omnistudio
release: "264"
---
# Omnistudio Data Mapper Transform Examples

Data Mapper Transform examples demonstrate how to convert a single item into a list with one item and how to convert a list of objects to a list of values.

For additional Data Mapper Transform examples, see [Transforming Lists with Data Mappers](https://help.salesforce.com/s/articleView?id=xcloud.os_list_input_for_dataraptors_47431.htm&release=264.0.0&type=5 "Data Mappers can perform list transformations. For mapping input to output, Data Mappers require a list input in which every value is paired with a key.") and [Use Formulas in Omnistudio Data Mappers](https://help.salesforce.com/s/articleView?id=xcloud.os_use_formulas_in_dataraptors_47540.htm&release=264.0.0&type=5 "To add data to the output of a Data Mapper, define formulas. Several types of Data Mappers (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).").

- **[Convert a Single Item to a List with One Item](https://help.salesforce.com/s/articleView?id=xcloud.os_convert_a_single_item_to_a_list_with_one_item_46799.htm&release=264.0.0&type=5)**  
    Sometimes, a component requires input as a list, but the input isn’t a list. You can use the Output Data Type setting in an Omnistudio Data Mapper Transform to convert JSON data to a list. Use a formula to remove the second level of the hierarchy.
- **[Convert a List of Objects to a List of Values](https://help.salesforce.com/s/articleView?id=xcloud.os_convert_a_list_of_objects_to_a_list_of_values_46859.htm&release=264.0.0&type=5)**  
    You can convert a list of JSON objects (key-value pairs in braces) to a list of single values, regardless of the length of the list. The trick is to use a formula to remove the second level of the hierarchy.
- **[Change the Hierarchical Level of a List](https://help.salesforce.com/s/articleView?id=xcloud.os_change_the_hierarchical_level_of_a_list_46934.htm&release=264.0.0&type=5)**  
    If a list is defined at the wrong level of a JSON node hierarchy, you can use an Omnistudio Data Mapper Transform to change the level at which the list is defined. This approach only works for a short list with a known number of items.