# Flexcard data sources and resulting JSON

*Omnistudio Developer Study Guide · Flexcards · Last updated October 27, 2026 · https://www.certifyforce.com/study-guide/omnistudio-developer/flexcards/flexcard-data-sources-and-resulting-json*

How to configure each Flexcard data source type (SOQL, SOSL, Data Mapper, Integration Procedure, Apex Remote, Apex REST, REST, Custom, Streaming API, autolaunched flow), fill input maps, options maps and JSON Payload, and test the returned JSON with test parameters, Save & Fetch and Result JSON Path.

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

**Official exam objective:**

> Configure data sources such as SOQL, Data Mapper, Integration Procedure, Custom, etc. and test resulting JSON structure.

## What the exam expects

- Configure each data source type: SOQL Query, SOSL Search, Data Mapper, Integration Procedure, Apex Remote, Apex REST, REST, Custom, Streaming API and autolaunched flow.
- Fill an input map with static values or single merge fields, and know which options map keys a type accepts.
- Set up a REST or Apex REST call: endpoint, GET or POST, JSON Payload, request headers and the Setup prerequisites.
- Test a data source with test parameters and Save & Fetch, then read the returned JSON.
- Write a Result JSON Path for an object root and for an array root.

Key terms: **input map** (key-value pairs the card sends to its source), **options map** (extra settings passed to an Apex Remote class or an Integration Procedure), **test parameter** (a designer-only value for a runtime variable), **Save & Fetch** (runs the source and shows Test Results), **Result JSON Path** (the response node the card uses as its records).

## Key facts

| Fact | Detail | Source |
|---|---|---|
| Integration Procedure input values | {}, {} format; array format isn't supported | [Data source setup](https://help.salesforce.com/s/articleView?id=xcloud.os_configure_a_data_source_on_a_flexcard_35864.htm&language=en_US&type=5) |
| Input map Value | Static values or merge fields such as {recordId} | [Data source setup](https://help.salesforce.com/s/articleView?id=xcloud.os_configure_a_data_source_on_a_flexcard_35864.htm&language=en_US&type=5) |
| useContinuation | Options map key on Integration Procedure sources; Winter '23 or later | [Data source setup](https://help.salesforce.com/s/articleView?id=xcloud.os_configure_a_data_source_on_a_flexcard_35864.htm&language=en_US&type=5) |
| Apex REST POST | Enter the JSON to send in JSON Payload | [Data source setup](https://help.salesforce.com/s/articleView?id=xcloud.os_configure_a_data_source_on_a_flexcard_35864.htm&language=en_US&type=5) |
| REST prerequisites | Remote Site Settings plus a trusted URL | [Data source setup](https://help.salesforce.com/s/articleView?id=xcloud.os_configure_a_data_source_on_a_flexcard_35864.htm&language=en_US&type=5) |
| Streaming API source | Managed package designer only | [Data source setup](https://help.salesforce.com/s/articleView?id=xcloud.os_configure_a_data_source_on_a_flexcard_35864.htm&language=en_US&type=5) |
| Apex Remote interface | VlocityOpenInterface is Managed Package Runtime only; Standard Runtime uses System.Callable | [Supported Features](https://help.salesforce.com/s/articleView?id=sf.os_omnistudio_and_omnistudio_for_vlocity_products_and_features_support.htm&language=en_US&type=5) |
| Context variables | All case-sensitive | [Context variables](https://help.salesforce.com/s/articleView?id=xcloud.os_flexcards_context_variables_42922.htm&language=en_US&type=5) |
| Test parameter Key | The runtime variable from the input map, such as recordId | [Test data sources](https://help.salesforce.com/s/articleView?id=sf.os_test_data_source_settings_on_a_flexcard_37522.htm&language=en_US&type=5) |
| Result JSON Path index | Only when the entire JSON is an array: [0]['Cases'] | [Data source properties](https://help.salesforce.com/s/articleView?id=xcloud.os_flexcards_data_source_properties_36016.htm&language=en_US&type=5) |

## Check yourself

- Why can't Result JSON Path fix a data source that returns no records?
- When does an Integration Procedure data source need useContinuation = true in its options map?
- When is the Streaming API data source unavailable?
- What do you click after adding a test parameter to see the returned data?

## Sources

- [Set Up a Data Source on a Flexcard](https://help.salesforce.com/s/articleView?id=xcloud.os_configure_a_data_source_on_a_flexcard_35864.htm&language=en_US&type=5)
- [Flexcards Data Source Common Properties](https://help.salesforce.com/s/articleView?id=xcloud.os_flexcards_data_source_properties_36016.htm&language=en_US&type=5)
- [Test Data Source Settings on a Flexcard](https://help.salesforce.com/s/articleView?id=sf.os_test_data_source_settings_on_a_flexcard_37522.htm&language=en_US&type=5)
- [Flexcards Context Variables](https://help.salesforce.com/s/articleView?id=xcloud.os_flexcards_context_variables_42922.htm&language=en_US&type=5)
- [Configure Flexcard Settings](https://help.salesforce.com/s/articleView?id=xcloud.os_set_up_a_flexcard_in_the_flexcard_designer_37646.htm&language=en_US&type=5)
- [Preview and Debug a Flexcard](https://help.salesforce.com/s/articleView?id=xcloud.os_preview_a_flexcard_41051.htm&language=en_US&type=5)
- [Omnistudio Supported Features](https://help.salesforce.com/s/articleView?id=sf.os_omnistudio_and_omnistudio_for_vlocity_products_and_features_support.htm&language=en_US&type=5)
- [Omnistudio Flexcards](https://help.salesforce.com/s/articleView?id=sf.os_omnistudio_flexcards_24388.htm&language=en_US&type=5)

## About the full unit

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