Tree

Name

Name that identifies the control. This value is also used for the label of the control.

XML Node

XML node mapped to the control. Use this value to map a list to a form and a form to a workflow.

• Prefix with @ to use the value of the control as an attribute with the immediate parent node. For example, @FirstName.

• Use / for a parent-child node configuration to uniquely identify a control in a form with multiple containers. For example, Employee/FirstName.

  The default value is the value for the Name property without the spaces.

Note:
- If you use / to denote a parent which is not a container and the parent is at the same level as that of the child, then the XML node for the control is not generated.
- If you edit this value later, then it might affect the mapping between forms, lists, and workflows.

Description

Description for the control.

Tooltip

Message that appears when the pointer hovers over the control.

Data Source

Lookup data source used to populate the tree.

To configure the lookup source

1. Click Data Source button to select the lookup data source.

2. In the Data Source Type list, select the type of data source.

3. In the Data Source list, select the data source.

4. Click Save & Continue.

Node ID Column

The column name of the column that contains IDs to identify every node used in the tree.

Node Parent Column

The column name of the column that contains IDs to identify parents of the nodes used in the tree.

Note: If the node parent column is blank in the configuration, or if the parent ID specified does not correspond to any node in the tree, then that node is placed on the root of the tree.

Node Label Column

The column name of the column that contains text to label the nodes used in the tree.

Visible

Show or hide the control.

• Select Yes to show the control.

• Select No to hide the control.

  The default value is Yes.

Label Position

Position of the label for the control.

• Select Default to allow the system to align the label. The system aligns the label to the left of the control or as specified by the container control.

• Select Left to align the label to the left of the control.

• Select Top to align the label to the top of the control.

• Select Right to align the label to the right of the control.

• Select Bottom to align the label to the bottom of the control.

• Select Suppress to hide the label for the control.

  The default value is Default.

Note:
- If the value is Default and the control is placed on a container control, then the value of the Label Position property of the container control determines the position of the label for the control.
- For example, if the value is Default and the control is placed on a Base Form with Label Position property set to Top, then the label is aligned to the top of the control.

Label-Control Area

Area occupied by the label and the control in percentage.

• Select Default to allow the system to set the label and the control areas.

• Select Custom to specify the label area. The control area is automatically set based on the label area.

  The default value is Default.

Note:
- If the value is Default and the control is placed on a container control, then the value of the Label-Control Area property of the container control determines the area of the label for the control.
- This is applicable only when the Label Position is set to Left or Right.

Retain Space

Reserve or remove space when the control is hidden.

• Select Yes to keep space when the control is hidden.

• Select No to remove space when the control is hidden.

  The default value is No.

Expand Nodes

Expand or collapse the nodes of the tree by default when the tree loads.

• Select Yes if you want the nodes of the tree to expand by default when the tree loads.

• Select No if you want the nodes of the tree to collapse by default when the tree loads.

  The default value is Yes.

On Data Bound

Run s script when data is bound to the control.

For more information, see scripting guidelines for On Data Bound property.

On Selection Change

Run a script when selection of the record changes.

For more information, see scripting guidelines for On Selection Change property.

On Check Change

Run a script when the state of the checkbox changes, that is when the checkbox is selected or cleared.

For more information, see scripting guidelines for On Check Change property.

ID

Reference identification code for the control. This value is automatically generated and cannot be changed.

Checkbox Behavior

Allow or deny a user to select single or multiple records for the control.

• Select Single to allow a user to select a single record for the control.

• Select Multiple to allow a user to select multiple records for the control.

• Select None to deny a user to select a record for the control.

  The default value is None.

Node Checked Column

Column name for selecting the checkbox in the control.

Inherit Checked State

Allow or deny the system to automatically inherit the state of the parent checkbox for the child nodes when the checkbox of the parent node is selected or cleared.

• Select Yes to allow the system to automatically inherit the state of the parent checkbox for the child nodes.

  For example,consider that Oil is the parent node with Crude and Refined as child nodes.

  When you set Inherit Checked State to Yes, and if you select Oil, then Crude and Refined inherit the state of the parent node Oil, and are automatically selected.

  If Oil is unchecked, and if you select Crude and Refined, then Oil automatically sets to an indeterminate state (dash). If Oil is checked, and if you select Crude and Refined, then Oil remains in a checked state.

  Note: There is no visual indication of the parent node in an indeterminate state.

• Select No to deny the system to automatically inherit the state of the parent checkbox for the child nodes.

  When you set Inherit Checked State to No, and if you select Oil, then Crude and Refined do not inherit the state of the parent node Oil, and do not get selected.

  The default value is No