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 template. Examples of dependencies are available from the Dependencies tab.

Options on the Dependencies Tab for the Advanced Task Template