Set Toggle Switch State in Data Design
Last updated
Last updated
Set Toggle Switch State in Data Design is a regular block that allows you to set the state of Checkbox and Toggle Switch elements that were generated using the Content from Data Design block and dynamically added to the page or form.
Checkbox and Toggle Switch elements, used inside a Data Design element, need to be initialized using the Initialize Toggle Switch in Data Design, after they are added to the page or form.
The behavior of the block is similar to the Set Toggle Switch State block, with some important differences:
Works only with elements generated using Content from Data Design block that are dynamically added.
Element Selection: You can only choose an element placed inside the selected Data Design element.
The block consists of the following (from top to bottom):
Data Design: Selectable Input to choose the Data Design element whose element you want to target.
Element: Selectable Input to choose the element, within the selected Data Design, you want to set the state of.
ID: Optional Value Parameter that accepts a text value representing the unique value that was provided to the Content from Data Design block. See below for more details.
ID2: Optional Value Parameter that accepts a text value representing the secondary identifier that can be used to identify the desired element. See below for more details.
Data: Value Parameter that accepts a boolean (true/false) type value to set.
The behavior of this block depends on the ID and ID2 value parameters and is detailed below:
ID and ID2 not provided: Operate on the selected element for all generated instances of the same Data Design element.
ID2 provided and ID not provided: Operate on the selected element for all generated instances of the same Data Design element with the same ID2 value.
ID provided and ID2 not provided: Operate on the selected element for all generated instances of the same Data Design element with the same ID value. Since we recommend the ID value to be unique, this would choose one from all the generated instances of the associated Data Design element.
ID and ID2 provided: Operate on the selected element for all generated instances of the same Data Design element with the same ID and ID2 value.
NOTE: Please refer to the prerequisite information shown here before seeing the example.
The image below shows an example in which the state of Toggle Switch element (Input51) is set to true for Company 2, which is rendered with the ID ST101 .
The result of the above example is highlighted below, where the Toggle Switch element (Input51) is turned to the ON position for Company 2.
In the second example, we will present the situation where neither ID nor ID2 are provided. In this scenario, the system will set the Toggle Switch element (Input51) to the ON position for all generated instances.
The result of the above example is highlighted below, where the the Toggle Switch element (Input51) is turned to the ON position for both the companies.
NOTE: The same examples also apply for a Checkbox element.
