Cloud MLTF
- 1 Options Trees
- 1.1 Create a tree
- 1.2 Manage options & levels
- 1.3 Options Trees Operations
- 1.3.1 Delete & Sort
- 1.3.2 Rename & Enable/Disable
- 1.3.3 Expand/Collapse & Return to Options Trees
- 1.3.4 Export & Import
- 1.3.4.1 Import Templates
- 2 Multi Level Custom Field Types
- 3 Jira Service Management
- 4 Dashboard & Gadgets
- 5 Search Work Items
- 5.1 JQL Functions
Multi Level & Tree Fields lets you model unlimited‑depth hierarchies and reuse them across custom fields.
You define one or more Options Trees, then create MLTF field types that reference those trees. Users select values while creating or editing work items.
Options Trees
An Options Tree is the reusable data source for your MLTF fields. You can have multiple trees for different use cases.
Create a tree
Go to Apps → MLTF → Options Trees and click Create Options Tree.
Give it a clear name (e.g., Product Catalog, Location Hierarchy).
Manage options & levels
Click Options on a tree to add items.
Level‑1 options: Create Option.
Child options: click the + next to a parent to add sub‑options.
Options Trees Operations
Delete & Sort
Rename & Enable/Disable
Important: Editing options does not change existing work items. New or edited options apply going forward. Historical work items retain the previously selected values.
When an option is disabled, its child options will be disabled as well.
Expand/Collapse & Return to Options Trees
Export & Import
Find the import templates below
MLTF supports XML, CSV, and JSON for bulk operations. Export before large edits; keep backups.
Re‑install safety: If you ever uninstall MLTF, export all trees first. After reinstalling, import using Merge with existing to retain original IDs and avoid breaking references.
Import Templates
You can download the import templates below.
Column Details
Columns (all mandatory): ID | Value | Enable | Parent
Rules:
ID: unique integer per option.Value: the label shown to users.Enable:TRUEorFALSE.Parent: use-1for top‑level items; otherwise set to the ID of the parent option.
ID (Each option should have an ID) | Value (Your options’ name) | Enable (Indicate the option is enabled or disabled - TRUE / FALSE) | Parent (For the first levels of all options use the “-1“, for others use the ID column) |
|---|---|---|---|
1 | Option 1 | TRUE | -1 |
2 | Option 1-1 | TRUE | 2 |
3 | Option 2 | TRUE | -1 |
4 | Option 2-2 | TRUE | 3 |
Multi Level Custom Field Types
Use the plugin’s five MLTF field types to tap into your Options Trees—create the custom fields you need, then add them to the appropriate screens and workflows.
Multi Level (Cascading)
Option Path (Multi Select)
Option Path (Single Select)
Tree (Multi Select)
Tree (Single Select)
Multi Level (Cascading)
A single Multi Level (Cascading) field covers your entire hierarchy. Create one and you’re set.
Select Multi Level (Cascading) → Configure → Choose Options Tree.
Auto-select next level (optional): Auto-pick the only child and continue
Cascading on Work Item
Option Path (Multi Select or Single Select)
Create an Option Path field (choose Single-select or Multi-select).
Open the field’s configuration → Options Tree mapping → select your Options Tree and Save.
Displays the full path (e.g., Region > Country > City) as the selectable value.
Toggle “Only leaf options are selectable” to enforce choosing the lowest level. Disable it to allow picking any level along the path.
Toggle “Load options dynamically”: If disabled, all options you’ve defined are listed. If enabled, only the first 100 levels are shown initially.
Choose single or multi‑select based on your use case.
Option Path on Work Item
Tree (Multi Select or Single Select)
Visual, expandable tree component for choosing items.
Create Tree type of field as multi select or single select.
Then edit option tree mapping, select Options Tree.
Only leaf options selectable: same behavior as above.
Collapse options: start with options collapsed for faster scanning.
Tree on Work Item
Jira Service Management
MLTF fields are fully supported on customer portal forms. Include them where needed—and set them as required.
Dashboard & Gadgets
Use the MLTF‑specific Pie Chart gadget to report on MLTF fields.
Visualization: choose Pie or Donut.
Data source: select a saved filter (JQL) that returns the work items you want to chart.
Field: pick the MLTF field to aggregate as the chart slices.
Search Work Items
Use Multi Level fields directly in JQL searches for precise filtering.
Add them as columns in issue navigator and easily export results with full hierarchy context.
JQL Functions
MLTF Field.Paths – return the full option path
MLTF Field.Values – return selected values
"Affected Business.Path" = "Network/Peering Partner/Zayo"
"Affected Business.Value" = "Core Router"