Setting component rules

Creating or configuring forms > Configuring the <components> element > Setting component rules

6.1.18 Setting component rules

This class represents a way to add requirements and rules to components. A component rule consists of two parts:

<requirement> - What must be evaluated to determine if a response should occur. The requirement can be any Boolean decider. It is evaluated when any of the components change.

<response> - What happens if the requirement is evaluated to true. The response can do one of the following operations: change the selectable values in a single select list box, change a component's (or a section's) visibility, validate or invalidate individual components, or get a dynamic component response.

To set a component rule

Inside the component, set the <component-rule> element.
Place the <requirement> element within <component-rule> and configure a Boolean value decider to be evaluated when any of the components change. See Setting a Boolean decider.
Within <component-rule>, configure the <response> element to perform one of the following operations:

Change the selectable values in a single-select list box. See Configuring a list box.

<component-rule>
  <requirement comparison="equals">
    <first>
      <component id="procs" />
    </first>
    <second>1</second>
  </requirement>
  <response>
    <component id="memory">
      <select-values>
        <select-value api-value="1" display-value="1 GB" />
        <select-value api-value="2" display-value="2 GB" />
        <select-value api-value="4" display-value="4 GB" />
      </select-values>
    </component>
  </response>
</component-rule>

If the user selects "1" as the value for the "procs" component, the options available for the "memory" component become "1 GB", "2 GB", and "4 GB".

Change a component's (or a section's) visibility. See Changing a component/section's visibility.
Validate or invalidate individual components. See Validating and invalidating components.
Get a dynamic component response. See Getting component rule responses dynamically.