You are here:
Access Flexcard Data JSON with Merge Fields (Managed Package)
For the managed package runtime, enable Flexcard element properties to access data JSON using merge fields. A merge
field is a variable that references the value of a JSON node. Merge field syntax requires you
to wrap a full JSON path with a curly bracket on both ends, such as {FirstName}. For example,
if a JSON node is "FirstName": "John", then the merge
field {FirstName} returns John.
This information is for Omnistudio for Managed Packages. For Omnistudio on standard runtime, see Omnistudio Help.
Only certain element properties support merge fields.
Common Use Cases
-
Set the value of an element's label with data coming from the data source. For example, on a Flexcard that displays an Account's primary contact information in a Block element, set the Title of the collapsible Block element to {PrimaryContactName}.
-
Pass data from from an Action element. For example, use an Update Omniscript action to pass data, such as {Id} and {Name}, from a Flexcard to the Omniscript it's embedded inside. See Update an Omniscript from a Flexcard (Managed Package).
-
Pass data to a child Flexcard from the parent's datasource. For example, update the contextId on a child Flexcard by passing {Id} as an attribute form the parent Flexcard. See Embed Flexcard Inside Another Flexcard (Managed Package).
-
Set the value of descriptive text for accessibility users. For example, select {AccountName} as the Alternative Text for an Image element that displays a company logo.
-
Display data as plain text with the Text element. For example, enter Hello {FirstName}! on a Contact Flexcard.
Additional Syntax
This table provides additional syntax examples for nested JSON.
JSON Node |
Merge Field Syntax Example |
|---|---|
|
To access a nested node, use a dot |
|
To access a specific item in a data field with an array, enter the number of the index surrounded by brackets, such as [0]. For example, [0] gets the first item, [1] gets the second item, and so on. |
- Access the Data JSON (Managed Package)
For the managed package runtime, use existing data JSON in an element property by indicating the use of a merge field.
