You are here:
Use the Conditional View Property to Conditionally Display Elements (Managed Package)
For the managed package runtime, every step, block, or element supports at least one Conditional View. Conditional Views allow you to hide the element or the group of elements contained in a block or step based on certain conditions. Elements contain up to three conditional view options depending on the type of element. For example, an Action outside of a Step doesn’t have a Read-Only option since the action isn’t visible.
This information is for Omnistudio for Managed Packages. For Omnistudio on standard runtime, see Omnistudio Help.
When you hide an element in an Omniscript, Omnistudio sets the contents of the element to null in the data JSON. Consider this behavior if your Omniscript references the hidden field. For example, suppose a Set Error element assesses whether a Text element is filled before proceeding to the next page. If the Text element is conditionally hidden, the Text element value is null, and the error is set.
- From the Properties section on the element, go to the Conditional View section.
-
Select a Condition Type from the dropdown menu.
LWC Omniscript Designer Conditions
Classic Omniscript Designer Conditions
Description
Show Element if True
Hide element if false
The element renders only if the conditional is true. If the conditional is false, the element is hidden from the UI.
For blocks, this condition type is the only one available.
Disable Read Only if True
Set element to read only if false
Disables Read Only on an element if the conditional is true. If the value is false, the element becomes Read Only.
Beginning with Vlocity Insurance and Health Spring '20, this Condition Type takes priority over the Read Only property in the element.
Set Element to Required if True
Set required element to optional if false
The element becomes required if the condition is true.
Beginning with Vlocity Insurance and Health Spring '20, this Condition Type takes priority over the Required property in the element.
Note If a condition type isn't listed for an element, it isn't supported. Adding it using the JSON editor doesn't work. - Choose the logical operator for the group (AND or OR). The AND operator requires that all conditions are met. The OR operator requires that at least one condition is met.
- Click Add Condition.
-
In the left operand, enter the name of the element in plain text.
Note
If the element is repeatable, enter the name of the element followed by |n, where n is the nth repeated element. For example, if Age is repeated, Age|2 refers to the second instance of the repeated element.
-
In the right operand, enter one of these syntax types:
-
If the element type is Text, enter the string in plain text.
-
If the element type is Checkbox or Disclosure, enter true or false.
-
If the element type is Number, enter a number.
-
If the element type is Select or Radio, type in the name of the option in plain text—for example, Yes or No.
-
If the element type is Multi-Select, enter a semicolon-separated string—for example .
-
If the element type is Date, Time, or Date/Time, enter a value in ISO format:
-
Date—2014-10-01T07:00:00.000Z (Wed Oct 01 2014 00:00:00 GMT-0700 (PDT)
-
Date/Time—1970-01-02T06:19:00.000Z (Tue Feb 17 2015 22:20:03 GMT-0800 (PST))
-
Time—2015-02-21T00:09:40.270Z (Thu Jan 01 1970 22:19:00 GMT-0800 (PST))
-
-
The right operand supports merge fields, for example
Name = %contactLastName%.
-
-
Beginning with Vlocity Insurance and Health Summer '20, in the canvas, click the
Hide Conditional Elements checkbox to hide all of the
conditional elements in the Omniscript. The conditional elements are marked with a
yellow eye icon.
-
In the canvas, click the Hide Conditional Elements checkbox
to hide all of the conditional elements in the Omniscript. The conditional elements
are marked with a yellow eye icon.
- Running Validation with onChange (Managed Package)
For the managed package runtime, beginning with Vlocity Insurance and Health Winter '20 and Vlocity CME Winter '20, LWC Omniscripts run validation when a user clicks out of a field by using the onBlur function.