Edit Tree Binding

Use this form to define and maintain the specifications for a Tree component.

This form is used only with Tree components.

This form includes these tabs, each with its own fields and options:

  • The General tab:
    Field/Option Description
    IDO Use this drop-down list to select the top-level IDO collection to which the Tree component is to be bound.

    The selected IDO populates child nodes from the root level of the tree.

    You can specify a label for the top-level node using the Caption property in the Component property sheet.

    You can also specify a root node icon using the Bitmap File Name property. The default icon represents a folder.

    Custom Load Method Use this drop-down list to select a custom load method or stored procedure to be used when displaying the Tree component.

    With a custom load method or stored procedure specified, you cannot alter the list of properties (Properties). The list of properties is automatically populated and the Properties field is read-only.

    You can use the TMP keyword to refer to a property value.

    Method Parms (Parameters) If a custom load method or stored procedure is specified in the Custom Load Method field, use this field to specify the method parameters to use.
    Note: When you select a method, the system automatically populates this field with the parameters used by that method.

    If a custom load method or stored procedure is not specified in the Custom Load Method field, this field is disabled.

    Properties Use this field to specify a comma-separated list of IDO properties to include in nodes at the root level.

    Use the ellipsis () button to launch a dialog box from which you can choose properties.

    Props To Display Use this field to specify what property values from the Properties list are to be displayed in each node. Properties are indicated by integers.

    Use the ellipsis () button to launch a dialog box in which you can select which properties (specified in the Properties field) to be displayed in the Tree.

    This feature allows you to include hidden properties in nodes. You can use the properties in linkages to the next level of the tree, and the properties can be accessed programmatically when the user clicks a node.

    Read Mode Use this field to set the isolation level for transactions when loading the collection for the current level. This setting overrides the default value for Collection Read Mode set in the Process Defaults form. The override applies only to the current IDO in the tree.
    Prefix/Format The prefix displays to the left of property values in nodes. You can specify a single prefix for all property values in a node or separate prefixes for each property value.

    To use a single prefix, type a literal value or select a translatable string from the list.

    Font Clicking this button launches a Font dialog box, in which you can specify the font to use for the Tree component nodes.
    All Levels Use Same IDO

    When this option is selected, the Tree component is defined as a recursive tree, that is, one in which each level of nodes uses the same IDO.

    When selected:

    • The Link By field on the Recursive Options tab is enabled and you can specify the recursive linkage from one level to the next on this IDO.
    • All options on the Specified Levels tab are disabled.

    When this option is cleared, the Specified Levels tab options are enabled, and you can specify the IDO collection for each sublevel of the tree independently.

  • The Load Options tab:
    Field/Option Description
    Filter Use this field to specify parameters for the FILTER keyword, which sets query criteria.
    Distinct When selected, this option applies the DISTINCT keyword to the collection of nodes. This prevents duplicate entries in the tree.

    When this option is cleared, the tree can have duplicate entries/nodes.

    Order By Use this field to specify what properties are used in sorting and presenting the returned data.

    If multiple properties are specified here, the system uses them in order, only applying secondary sort properties if there are duplicate primary properties.

    Group By Use this field to specify the properties by which nodes are to be placed into groups.
    Rec. Cap Override Use this field to specify a record cap for the selected collection.

    This setting is subject to any system-wide record cap overrides that might be in effect.

  • The Image Filename tab:
    Field/Option Description
    Image Use this field to specify a node image to represent this level of the tree. The graphic file should be located on the client.

    The default icon represents a folder.

    Selected Image Use this field to specify a node image (such as an open folder) to indicate that a node is selected. If Image is specified and Selected Image is not specified, Image is used in both the selected state and the non-selected state. The graphic file should be located on the client.
  • The Recursive Options tab:
    Note: Unless the All Levels Use Same IDO option is selected on the General tab, all options on this tab are disabled.
    Field/Option Description
    Ignore Target Level Filter Spec When selected, this option instructs the system to ignore the target node’s Filter specification while looping back.
    Link By Use this field to set the linkage between levels in a recursive tree.
    Method Parms (Parameters) Use this field to add, edit, or reorder parameters required by a custom load method.
  • The Specified Levels tab:
    Note: If the All Levels Use Same IDO option is selected on the General tab, all options on this tab are disabled.
    Field/Option Description
    Up Click to move a selected level up one level in the list.
    New Click to create a new level.

    When you click this button, the Tree Binding For Sublevel form is launched. Use that form to define the properties and attributes of the new level.

    Edit

    Click to edit a selected existing level.

    When you click this button, the Tree Binding For Sublevel form is launched. Use that form to edit the properties and attributes of the existing level.

    Delete Click to delete a selected level.
    Down Click to move a selected level down one level in the list.