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 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.
Copyright © SAS Institute Inc. All rights reserved.