| Table of Contents |
|---|
| Note |
|---|
Multi Level & Tree Field provides to create Multi Level and Tree custom field and edit the data it contains. |
Options Tree
You should create the topmost item from the Options Trees 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.
...
...
| View file | ||
|---|---|---|
|
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.
...
Level 1 options can be created by the Create Option button. Each option you create with this button will be on the first level.
Any option may be restricted to a particular issue type or group.
...
You can also create multiple options.
...
Add multiple parent options or sub-options splitting with “;“
...
Also, for the sub-options, use the plus sign next to the relevant parent option
...
for which you are willing to create sub-options.
...
...
With the button next to the plus sign, you can edit your options, and enable, or disable them at any time.
| Note |
|---|
Important Warning! When you edit your options, it will not affect previously selected issues. Only new issues will reflect the updated options. |
&
...
The Multi Level Custom Field Types
To make use of the Options Tree definitions there are
...
five 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.
...
...
Multi Level
...
Then edit options tree mapping,
...
For the first level of the hierarchy, select “Connect to top of options tree“ and select the option tree.
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.
For the lower levels, select “Connect as cascading child field“ and select the parent custom field.
...
Congratulations! You can now use your Multi Level fields on screens.
...
...
(Cascading)
One Multi Level Cascading field is enough for your all levels! Create Multi Level (Cascading) field.
...
Then configure the field and edit options tree mapping,
...
Select your Options Tree and Save.
...
Now use your Multi Level (Cascading) field on screens.
...
Option Path (Multi Select or Single Select)
Create Option Path type of field as multi select or single select.
...
Then edit option tree mapping, select Options Tree
...
Select Option Tree
Only leaf options are selectable means that selection should be made at the lowest level.
...
The example below
...
should be the third level. If you disable this option, all levels become selectable.
...
Tree (Multi Select or Single Select)
Create Tree type of field as multi select or single select.
...
Then edit option tree mapping,
...
...
select Options Tree
Only leaf options are selectable means that selection should be made at the lowest level.
...
The example below
...
should be the third level. If you disable this option, all levels become selectable.
If you select Collapse options, at first, you will see your options collapsed
...
Auto select children means that the selection of a parent will include all the children.
...
.
...
Ready to go!
...
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.
...
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.
...
Option Move
If you want to change the options hierarchy, click on the specific option, use the Move button, and select the new parent option. To move an option to the first level, please select None and move.
...
Import/Export
There is an export option in every Options Tree Configuration. You can export your options as XML.
...
Also, you can bulk import your options from the Options Tree Configuration home page.
...
Sync Data Source with Options Tree
You can sync your Options Tree with a data source using API!
Manage Apps > Multi LEvel & Tree Fields > Data Source > Create Data Source
...
Enter your data source API information!
After giving a name, continue with choosing the http method to use.
...
Then, enter the URL. The default timeout duration is set to 10, but you have the option to change it.
...
In the Response section, fill the ID and values. Before create, test your connection!
...
Link Your Data Source with Options Tree
After creating a blank Options Tree, use the Link button under the Actions.
...
Choose your Data Source and synchronization time interval.
...
You can use the Sync Options Now button to sync your options manually!
...
| Info |
|---|
If the plugin needs to be uninstalled for reinstallation, please remember to export all of your trees before uninstalling, as they will be deleted. After reinstalling, import them using the "Merge with existing" option to keep your IDs the same.  |
...
Jira Service Management
You can use MLTF custom fields on the portal.
| Note |
|---|
They will appear hidden but will be located at the bottom of the portal screen. They should not be mandatory. |
...
