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.
This feature is supported for traditional navigation bar items only.
For this, a new parameter,
PERFORM-ACTION-NAV-FIELD-SET-SELECTED-ITEM, has been introduced with the following syntax:
FieldIDis 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: