Access Omniscript Data JSON with Merge Fields

Common Use Cases for Accessing JSON with Merge Fields

Learn about common use cases for accessing Omniscript data JSON with merge fields.

• Setting Values to rename elements, access JSON nodes, run formulas, and populate elements. For more information, see Set Values in an Omniscript
• Access data stored in Omniscript elements in a formula or in a future step.
• Access data returned from an Action. For example, an HTTP Action or Omnistudio Data Mapper Action returns data from Salesforce or an external source. For more information on Actions, see Omniscript Action Elements.
• Access data passed in as a parameter from a page.

Access the Data JSON

Use existing data JSON in an element property by indicating the use of a merge field.

1. Locate the name of the JSON node in the Omniscript's data JSON.
   
2. Enter the name of the JSON node and wrap the name in percentage signs to indicate it is a merge field.

   For example, a merge field accessing a JSON node named firstName must use the syntax %firstName%.

   
3. Preview the Omniscript to ensure the Merge field works correctly.
   

Additional Syntax

Check out additional syntax examples for nested JSON.

"ContactInfo": {
    "FirstName": "John"
  }

%ContactInfo:FirstName%

"ParentObject": {
    "NumberMap": [
      1,
      2,
      3
    ]
  }

%ParentObject:NumberMap|3%

 "ContactInfoStep": {
    "ContactInfoBlock": [
      {
        "FirstName": "John"
      },
      {
        "FirstName": "Adam"
      },
      {
        "FirstName": "Steve"
      }
    ]
  }

%ContactInfoStep:ContactInfoBlock|n:FirstName%