About the Dependencies Element

The Dependencies element specifies how certain options or roles rely on one another in order for the task to work properly. For example, a check box can enable or disable a text box depending on whether the check box is selected. The Dependencies element is a grouping mechanism for the individual Dependency tags. There are no attributes associated with this element.

The Dependencies element can have multiple Dependency tags. Each Dependency tag has a condition attribute that is resolved to determine the state of the targets. A dependency can have multiple Target elements.

The Target element has three required attributes.

Attribute	Description
`option`	references the option that receives the action. Valid values are `OptionItem`, `Role`, `OptionChoice`, or `Group` element.
`conditionResult`	specifies when to execute the action. The valid values for this attribute are `true` and `false`. If the condition is true and `conditionResult=true`, the action is executed. If the condition is false and `conditionResult=false`, the action is executed. If the value of the condition and `conditionResult` do not match (for example, one is true and one is false), the action is ignored.
`action`	specifies the action to execute. Here are the valid values: `show` `hide` `enable` `disable` `set` If the value of the `action` attribute is `set`, you must also specify these two attributes: The `property` attribute refers to the attribute of an element that was created from the metadata. The `option` element in the metadata has an `inputType` attribute that specifies what UI element is created. Note: Here are a few exceptions: In the `UI` element, any `RoleItem` element cannot be the target of a dependency where `action=set`. The `required`, `width`, `indent`, and `variable` (for the radio input type) attributes are invalid values for the `property` attribute of a `Target` element. The `value` attribute is the value to use for the target of the `property` attribute. If the `value` attribute targets an item with the `select` input type, the `value` attribute can accept a single value or a comma-separated list of values. Note: If the dependency has a comma-separated list of values and the `select` element that the dependency targets is set to `multiple=”false”`, only the first value in the comma-separated list is evaluated. The rest of the values in the list are ignored.

To understand how dependencies work, run the Advanced Task . Examples of dependencies are available from the Dependencies tab.

Options on the Dependencies Tab for the Advanced Task