# Turbo Extract: single object and related fields

*Omnistudio Developer Study Guide · Data Mappers · Last updated October 27, 2026 · https://www.certifyforce.com/study-guide/omnistudio-developer/data-mappers/turbo-extract-single-object-and-related-fields*

How to configure a Data Mapper Turbo Extract: one object with related-object fields up to five levels, the filter options including IN and paging, the always-selected Id, what Turbo can't do, Options-tab caching and testing in Preview.

- Certification: Salesforce Omnistudio Developer
- Exam section: Data Mappers
- Study guide: https://www.certifyforce.com/study-guide/omnistudio-developer

**Official exam objective:**

> Configure and retrieve data from a single object and related fields using Turbo Extract Interface.

## What the exam expects

- Recognise when a requirement fits a Turbo Extract (one object plus parent fields, no formulas or custom output mapping) and when it needs an Extract.
- Select base-object and related-object fields, and predict that the Id is always returned.
- Configure Turbo Extract filters: IN for arrays, AND/OR, LIMIT, OFFSET from an input node and ORDER BY.
- Set caching on the Options tab and test the Turbo Extract in Preview with Edit as Params and the Debug Log.

Key terms: **Turbo Extract** (a Data Mapper that reads a single object type plus related-object fields), **Selected Fields** (the fields the Turbo Extract returns), **Related Objects** (the list that walks child-to-parent relationships), **IN operator** (matches a field against items in an input array), **Ignore Cache** (the Preview setting to clear when you want to see caching).

## Key facts

| Fact | Detail | Source |
|---|---|---|
| Scope | One object type plus related-object fields | [Data Mappers](https://help.salesforce.com/s/articleView?id=xcloud.os_omnistudio_dataraptors_45587.htm&language=en_US&type=5) |
| Not supported | Formulas, custom JSON, default values, transformations | [Data Mappers](https://help.salesforce.com/s/articleView?id=xcloud.os_omnistudio_dataraptors_45587.htm&language=en_US&type=5) |
| Id field | Always included in Selected Fields | [Configure Turbo Extract](https://help.salesforce.com/s/articleView?id=xcloud.os_configure_a_dataraptor_turbo_extract_45667.htm&language=en_US&type=5) |
| Relationship depth | Up to five levels, child to parent only | [Configure Turbo Extract](https://help.salesforce.com/s/articleView?id=xcloud.os_configure_a_dataraptor_turbo_extract_45667.htm&language=en_US&type=5) |
| IN operator | Turbo Extract only; matches items in an input array | [Configure Turbo Extract](https://help.salesforce.com/s/articleView?id=xcloud.os_configure_a_dataraptor_turbo_extract_45667.htm&language=en_US&type=5) |
| OFFSET | Input node name; values 0 to 2000 | [Configure Turbo Extract](https://help.salesforce.com/s/articleView?id=xcloud.os_configure_a_dataraptor_turbo_extract_45667.htm&language=en_US&type=5) |
| Cache retention | Minimum 5 minutes | [Configure Turbo Extract](https://help.salesforce.com/s/articleView?id=xcloud.os_configure_a_dataraptor_turbo_extract_45667.htm&language=en_US&type=5) |
| Preview | Edit as Params, Execute; Debug Log shows the queries | [Preview and Test](https://help.salesforce.com/s/articleView?id=xcloud.os_preview_test_datamappers.htm&language=en_US&type=5) |

## Check yourself

- Why would a Turbo Extract be chosen over an Extract for a single-object list?
- When must you replace a Turbo Extract with an Extract?
- Which filter operator exists only on Turbo Extract?
- Why can't a Turbo Extract handle inputs such as FirstName `T'an` together with LastName `C'os`?

## Sources

- [Configure a Data Mapper Turbo Extract](https://help.salesforce.com/s/articleView?id=xcloud.os_configure_a_dataraptor_turbo_extract_45667.htm&language=en_US&type=5)
- [Omnistudio Data Mappers](https://help.salesforce.com/s/articleView?id=xcloud.os_omnistudio_dataraptors_45587.htm&language=en_US&type=5)
- [Preview and Test Data Mappers](https://help.salesforce.com/s/articleView?id=xcloud.os_preview_test_datamappers.htm&language=en_US&type=5)
- [Relationship Notation versus Multiple Extract Steps](https://help.salesforce.com/s/articleView?id=xcloud.os_relationship_notation_versus_multiple_extract_steps_45995.htm&language=en_US&type=5)
- [Design Data Mappers for Performance (Trailhead)](https://trailhead.salesforce.com/content/learn/modules/omnistudio-data-mapper-fundamentals/design-data-mappers-for-performance)
- [Data Mapper (Omnistudio Data Mapper APIs)](https://developer.salesforce.com/docs/atlas.en-us.psc_api.meta/psc_api/omnistudio_data_mapper_apis.htm)

## About the full unit

The "Core concepts", "Exam traps" and "Worked scenario" sections of this unit, its 4 linked practice questions, and unlimited timed mock exams are included with the Omnistudio Developer pack (USD $19): https://www.certifyforce.com/practice-exams