Page Comparison

Appanvil karma designer

summary

Cascading Select The Cascading Select field enables you to create structured and interdependent selections that reflect the complexity of your tasks, issues, or projects. By offering a multi-tiered selection process, this field empowers you to capture detailed information and streamline your workflows more efficiently.

page

{"premium":true,"name":"page","children":[{"id":"lfi8jBK4QX7bZqV_gWgeY","params":{"padding":0,"gap":10},"children":[{"id":"4CbdZ7_dJ3MWntvqkjFGj","name":"row","children":[{"id":"Ml3GxyZGc0_1glcmlCN5T","name":"column","children":[{"name":"text","params":{"templateId":"simple paragraph","value":[{"type":"paragraph","children":[{"type":"paragraph","children":[{"lineHeight":"24px","letterSpacing":0,"text":"Cascading Select","fontFamily":"unset","fontWeight":700,"color":{"light":"#ffffff"},"fontSize":38}],"align":"left"}]}]},"children":[],"id":"D-3o-sTBlkZadeqUR9Lvu"},{"name":"text","params":{"templateId":"simple paragraph","value":[{"type":"paragraph","children":[{"type":"paragraph","children":[{"fontSize":16,"letterSpacing":0,"text":"The Cascading Select field enables you to create structured and interdependent selections that reflect the complexity of your tasks, issues, or projects. By offering a multi-tiered selection process, this field empowers you to capture detailed information and streamline your workflows more efficiently.","fontFamily":"unset","color":{"light":"#ffffff"},"fontWeight":300,"lineHeight":"24px"}]},{"type":"paragraph","children":[{"fontSize":16,"lineHeight":"24px","color":"#555","letterSpacing":0,"fontFamily":"Open Sans, sans-serif","text":""}]}]}]},"children":[],"id":"qKhLt_zHxxujmz0UxfE5d"}],"params":{"borderRadius":{"all":0,"btl":0,"bbl":0,"btr":0,"bbr":0,"isIndividualCorners":false},"padding":0,"gap":20,"verticalAlignment":"center"}},{"id":"rbN56ddPTY151_82JQ3aq","name":"column","children":[{"name":"image","params":{"templateId":"full-width rounded","alignment":"center","position":"center center","borderRadius":{"all":0,"bbl":0,"bbr":0,"btl":0,"btr":0,"isIndividualCorners":false},"image":{"value":"att48791554","target":"_blank","type":"attachment"},"shouldOpenDialog":false,"width":200},"children":[],"id":"IHu1TOIZOzh3zv5Knf1fu"}],"params":{"borderRadius":{"all":0,"btl":0,"bbl":0,"btr":0,"bbr":0,"isIndividualCorners":false},"padding":0,"gap":20,"verticalAlignment":"center"}},{"id":"A8gNlWXe1IOREb1gCyZgH","name":"column","children":[],"params":{"borderRadius":{"all":0,"btl":0,"bbl":0,"btr":0,"bbr":0,"isIndividualCorners":false},"padding":0,"gap":20,"verticalAlignment":"center"}},{"id":"7tfYpIybnZmE7i-vXXYHG","name":"column","children":[],"params":{"borderRadius":{"all":0,"btl":0,"bbl":0,"btr":0,"bbr":0,"isIndividualCorners":false},"padding":0,"gap":20,"verticalAlignment":"center"}},{"id":"6TF--QtVlrhBL6e_JEMgp","name":"column","children":[],"params":{"borderRadius":{"all":0,"btl":0,"bbl":0,"btr":0,"bbr":0,"isIndividualCorners":false},"padding":0,"gap":20,"verticalAlignment":"center"}},{"id":"ZDmuwcveLIDZdH2zmRUrN","name":"column","children":[],"params":{"borderRadius":{"all":0,"btl":0,"bbl":0,"btr":0,"bbr":0,"isIndividualCorners":false},"padding":0,"gap":20,"verticalAlignment":"center"}}],"params":{"layout":[1,1],"gap":10,"minHeight":200,"padding":50,"borderRadius":25,"size":"full","backgroundColor":"#592360"}}],"name":"section"}],"id":"SK_jc3s-_GRiwqh2cB5Tn"}

Field Configuration

Info

Before starting the field configuration, please follow the instructions for creating custom fields

Create a Custom Field

Step 1: Set a name and description

Provide a good name for the new custom field. Make it descriptive, concise, and easy to understand for others who will use it. Avoid using ambiguous or overly technical terms.

Step 2: Add options

This field allows you to create as many levels as needed to cover your requirements. You can also define display options or if all levels have to be selected to prevent empty fields.

Step 3 (Optional): Add custom field labels

In conjunction with the select options, you can further enhance customization by adding custom labels for each option level. To do so, enable the "enable field label per parent" option and click "Edit field level" for the specific option level you wish to customize.

Step 4 (Optional): Customize display and required status

Regarding the display option, you have the flexibility to choose between showcasing the entire path or just the final option. For example a full path may look like this: Option 1 -> Option 1.1 -> Option 1.1.1 , whereas last step like this: Option 1.1.1.

If you want the cascading select to be completely selected, check the required selection toggle. This important if you want the field to be required.

A note to additional storage

In the case of extensive configurations with a multitude of options or levels (exceeding 500), you might encounter the maximum storage capacity for the field configuration. In such instances, a warning will prompt you to consider upgrading to a larger storage capacity to accommodate additional options.

Note
Please be aware that modifying this storage option will result in the complete deactivation of the cascading select functionality in Jira Service Management, impacting both the request form and portal view. This is due to technical limitations.

Field view and edit

Related Use Cases

Info
More use cases are coming soon. In the meantime, check out our other use cases.

Jira Service Management (JSM)

Info

Before you can add a custom field for Jira Service Management (JSM) projects, you first need to setup the custom field

https://help-seibertmedia.atlassian.net/wiki/spaces/ACF/pages/12288051/Cascading+Select#Field-Configuration

Then follow this guide to use the field in the request form or the portal view

Add Custom Fields to Jira Service Management

JQL expression

Warning
The Cascading Select is not compatible with JQL queries.

Data Structure (Automation)

Info
Use custom fields with automation

To set the value via automation, you need the following object structure

Code Block
{ "selection": [ { "id": number, "name": string, "children": number[] } ] }

We know that this is kind of complex (depending on the number of levels). So here’s an example of the configuration used in the screenshots above.

Code Block

{
  "selection": [
    {
      "id": "0",
      "name": "Option 1",
      "children": [
        "2"                     <-- the id of Option 1.1
      ]
    },
    {
      "id": "2",
      "name": "Option 1.1",
      "children": [
        "3"                     <-- the id of Option 1.1.1
      ]
    },
    {
      "id": "3",
      "name": "Option 1.1.1",
      "children": []
    }
  ]
}

Tip: To get the actual values, we recommend to print out the desired value first. this can be done via an automation rule that writes the value into a simple text field.