Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Table of Contents



Note

Multi Level & Tree Field provides to create Multi Level and Tree custom field and edit the data it contains. 
It allows branches of unlimited depth under the newly created options tree. The data that is required to appear in each opened tree is created by following the relevant screens below.
Each option created represents a tree structure in itself.

Options Tree

You should create the topmost item from the Options Tree Configuration to define tree levels. There can be more than one Options Tree. The example below shows the addition of an Options Tree. Children's options can be managed by clicking on the edit button on the right side of each Options Tree.

Image Removed
Image Added


Managing Sub-Options

There can be many levels of sub-options bound to an Options Tree. It is best to describe the definition of sub-options by example.

Image Removed
Image Added

Level 1 options can be created by the Create Option button. Each option you

will

create with this button will be on the first level. 

Image Removed


Image Added

Any option may be restricted to a particular issue type or group. 

Image Removed



Image Added

For the sub-options, use the plus sign next to the relevant parent option that you are willing to create sub-options.

Image Removed


Image Added




The Multi Level Custom Field Types

Multi Level

Multi Level (Cascading)

Option Path (Multi Select)

Option Path (Single Select)

Tree (Multi Select)

Tree (Single Select)

To make use of the Options Tree definitions there

is a Custom Field type named

iare six types of Multi Level customfield provided by the plugin that can be used to create Custom Fields and add them to respective screens and workflows.

Image Removed

Mapping Options to a Custom Field

To map an Options Level to the newly created custom field you need to click on "Edit Options Tree Mapping" on the custom field configuration screen.

Image Removed

Multi Level

Image Added

Image Added

When mapping the level 1 custom field, the "Connect to top of options tree" option should be selected and, as a Custom Field, you will select your highest level custom field that you created before.

For the child levels, you should select the "Connect as cascading child field" option and then select the Custom Field in which your child options will appear. 

The defined custom fields can now be added to issue create/edit screens for use.

Image Removed

Adding Custom Fields to Screens

After the custom field configuration is complete, the fields can be added to screens. As there is a separate custom field for each category level, it is important to place them on the screens in order to achieve correct cascading behavior.

Image Removed

The Tree Custom Field

To make use of the Options Tree definitions there is a Custom Field type named Tree provided by the plugin that can be used to create Custom Fields and add them to respective screens and workflows. 

Tree type of custom field can be created as Multi Select or Single Select as your choice.

Image Removed

The Option Path Custom Field

To make use of the Options Tree definitions there is a Custom Field type named Option Path provided by the plugin that can be used to create Custom Fields and add them to respective screens and workflows. 

The Option Path type of custom field can be created as
Image Added
Image Added

Multi Level (Cascading)

Option Path (Multi Select or Single Select

as your choice.

Image Removed

Option Path Customfield view:

Image Removed

Mapping Options to a Custom Field

To map an Options Level to the newly created custom field you need to click on "Edit Options Tree Mapping" on the custom field configuration screen.

Image Removed

When mapping a Tree type of field, you will select the whole Options Tree as a package. 

Image Removed

)

Image Added

Image Added

Only leaf options are selectable means

that selection

that selection should be made at the lowest level. In the example below, it should be the third level. If you disable this option, all levels become selectable.

Image Removed

Custom Fields

In the Custom Fields section, all

Image Added

Tree (Multi Select or Single Select)

Image Added

Image Added

Image Added

Adding Custom Fields to Screens

After the custom field configuration is complete, the fields can be added to screens. As there is a separate custom field for each category level, placing them on the screens is important to achieve correct cascading behavior.

Image Added


Custom Fields

All the Multi-Level and Tree type fields are listed in the Custom Fields section. You can configure or clear custom field levels from this section easily.

Image Removed
Image Added

Option Move

If you want to change the options hierarchy,

you need to

click on the specific option

and nameMUltiLevelMove

, use the Move button, and select the new parent option. To move an option to the first level, please select None and move.

Multimediawidth1200autostarttrue

height500


Import/Export

There is an export option in every Options Tree Configuration. You can export your options as XML.

Image Removed
Image Added

Also, you can bulk import your options from the Options Tree Configuration home page.

Image Removed
Image Added