Creating Trees

You can use a tree in your application to effectively communicate hierarchical or multiple level data.

Topics in this section include:

How To Create a Tree

To create a tree:

  1. Navigate to the Shared Components page:

    1. Navigate to the Workspace home page.

    2. Click the Application Builder icon.

    3. Select an application.

    4. On the Application Builder home page, click Shared Components.

  2. Under Navigation, click Trees.

    The Trees page appears.

  3. Click Create.

    The Create Tree Wizard appears. Note that each wizard page displays a series of blocks on the left, representing the sequence of steps. The highlighted block indicates the step you are performing.

  4. For Page Attributes, enter basic page information and click Next.

    To learn more about a specific item on a page, click the item label. A Help window appears with a description of the item or field.

  5. For Tab, specify how tabs should be implemented and click Next.

  6. For Tree Attributes:

    1. Tree Name - Enter a name.

    2. Default Expanded Levels - Specify the number of default expanded levels.

    3. Start Tree - Specify how you want to determine the starting point. This determines what point in the hierarchy you want to display.

      - Based on New Item with Popup List of Values - Select this option to set up an item containing a list of values. This option enables the user to determine the starting point to display by selecting an option for the list of values.

      - Based on a SQL Query - Select this option to write a query that dynamically finds the starting point of a hierarchy (the entry with no parent).

      - Static Value - Select this option to hard code the starting point.

    4. Click Next.

  7. For Tree Template, select a template and click Next.

  8. For Tree Start, specify a starting point and click Next. Depending on your Start Tree selection, enter either a query or a single value.

  9. For Expand/Collapse, select the buttons to include and click Next.

  10. For Table/View Owner, specify the owner of the table on which the tree will be based and click Next.

  11. For Table/View Name, specify the name of the table on which the tree will be based and click Next.

  12. A tree is based on a query and returns data that can be represented in a hierarchy. This hierarchy is determined by the relationship between ID and Parent ID values. Identify the column you want to use as the ID, the Parent ID, and specify the text that should appear on the leaf nodes.

    1. ID - Enter the column you want to use as the ID.

    2. Parent ID - Enter the Parent ID.

    3. Leaf Node Text - Specify the text that should appear on the leaf nodes.

    4. Link Option - Select Existing Application Item to make the leaf node text a link. If you select this option, specify a page to link to.

  13. Identify an optional where and order by clause to add to your query.

  14. Specify the display text for the Go button.

  15. Identify the page you want to branch to when the user clicks a button.

  16. Click Finish.

Editing a Tree

Once you create a tree, you can edit it on the Trees page.

To edit a tree:

  1. On the Workspace home page, click the Application Builder icon.

  2. Select an application.

  3. On the Application home page, click Shared Components.

  4. Under Navigation, select Trees.

    The Trees page appears.

  5. You can change the appearance of the page by making a selection from the View list:

    • Icons (the default) displays each tree as a large icon.

    • Details displays each tree as a line in a report.

  6. Select a tree.

    The Edit Tree page appears.

  7. Edit the appropriate attributes.

  8. To learn more about a specific item on a page, click the item label.

    When Help is available, the item label changes to red when you pass your cursor over it and the cursor changes to an arrow and question mark. See "About Field-Level Help".

  9. Click Apply Changes.

About Navigation Alternatives

The Edit Tree page is divided into the following sections: Name, Query, Before and After, Static Node Templates, Dynamic Templates, Node Text Templates, and Link Templates.

You can access these sections by scrolling down the page, or by clicking a navigation button at the top of the page. When you select a button at the top of the page, the selected section appears and all other sections are temporarily hidden. To view all sections of the page, click Show All.

Accessing Tree Reports

You can view the Trees Utilization and Tree History reports by clicking the appropriate tab at the top of the Trees page.


The Utilization and History buttons only appear after you have created a tree.

Tree Utilization

Click Utilization on the Trees page to access the Tree Utilization report. This report displays all trees included in the current application. To edit a tree, select the tree name.

Tree History

Click History on the Trees page to view changes to trees by developer and date.