Expanding and collapsing items in the navigation bar

When you open a form with a vertical navigation bar field with traditional navigation bar items, all the items are initially collapsed. You can expand or collapse all the items of the navigation bar field simultaneously, that is, you do not have to click all the nodes individually to search for the required node.

For this, a new parameter, PERFORM-ACTION-NAV-FIELD-SET-SELECTED-ITEM, has been introduced with the following syntax:

PERFORM-ACTION-NAV-FIELD-SET-SELECTED-ITEM FieldID state

where,

• FieldID is the field ID of the navigation bar or the navigation bar item.
• state (optional) for preserving backward compatibility. It's values can be one of the following:
  • 0 — Collapse all items recursively
  • 1 — Expand all items recursively
  • 2 — Collapse single level
  • 3 — Expand single level

Use Case 1-Expanding all items in the navigation bar field recursively

To expand all the items in the navigation bar field, execute the following command by providing the vertical navigation bar field ID:

PERFORM-ACTION-NAV-FIELD-SET-SELECTED-ITEM 536870978 1

Use Case 2-Expanding an item in the navigation bar field at a single level

To expand only a single item in the navigation bar field (non-recursively), execute the following command by providing the vertical navigation bar field ID:

PERFORM-ACTION-NAV-FIELD-SET-SELECTED-ITEM 536871021 2

If you specify a navigation bar field ID (as given in the following command), instead of the vertical navigation bar field ID, the first level in the navigation bar will be expanded.

PERFORM-ACTION-NAV-FIELD-SET-SELECTED-ITEM 536870978 2

Use Case 3-Selecting a navigation item with highlight

To select a navigation item with highlight, execute the following command by providing a leaf node with no options:

PERFORM-ACTION-NAV-FIELD-SET-SELECTED-ITEM 536870980