Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Appanvil karma designer
summary Issue Picker The Issue Picker empowers users and agents to associate related issues with the current Jira ticket. The linked issues are presented in a tabular format, showcasing issue key, summary, and status. When utilized in a service request, it facilitates customers in tracking the status of related internal Jira issues without providing access to the entire dataset.
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":[{"letterSpacing":0,"text":"Issue Picker","fontFamily":"unset","fontWeight":700,"color":{"light":"#ffffff"},"fontSize":38,"lineHeight":"38px"}],"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 Issue Picker empowers users and agents to associate related issues with the current Jira ticket. The linked issues are presented in a tabular format, showcasing issue key, summary, and status. When utilized in a service request, it facilitates customers in tracking the status of related internal Jira issues without providing access to the entire dataset.","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":"att45121550","target":"_blank","type":"attachment"},"shouldOpenDialog":false,"width":340,"height":187},"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":420,"padding":50,"borderRadius":25,"size":"full","backgroundColor":"#592360bf","backgroundImage":{"value":"att55345153","target":"_blank","type":"attachment"}}}],"name":"section"}],"id":"SK_jc3s-_GRiwqh2cB5Tn"}

On this page

Table of Contents
minLevel1
maxLevel2
include
outlinefalse
indent
excludeOn this page
typelist
class
printablefalse

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: Default configuration

The Issue Picker can be utilized without additional configuration. For advanced configuration options, refer to the following sections.

Step 3 (optional): add custom JQL including placeholders

To refine the selection of issues available for linking in the issue picker, you have the option to supply custom JQL (Jira Query Language). Additionally, you can employ placeholders that are dynamically replaced with the current issue context.

Info

Placeholders

Consider using the issue picker in a project like 'ACF'; your JQL might appear as follows before and after replacement:

project = {{project.key}}project = ACF

You may use the following placeholders:

{{issue.key}}, {{issue.type}}, {{project.key}}, {{project.type}}

Note

Placeholder usage is limited to the issue view and may not be applicable in the issue create form and JSM request form. Using placeholders will generate an invalid JQL query in the search. For testing purposes, replace them with specific issue information.

Step 4 (optional): Skip permission check

Using this option allows you to bypass Jira permissions in service requests and make all selected issues visible (read-only) to anyone with access to the current service request in your Jira.

Please be careful when using this option and make sure you are aware of the impact.

Info

Needed to be compatible with Jira Service Management

Step 5 (optional): Restrict the number of issues

Utilizing this option allows you to manage and control the number of links that can be established.

Info

This option can lead to confusing behaviour with “reciprocal links“ (Step 6).

Step 5 (optional): Link back

Enabling this option establishes a reciprocal link for each connection made. Consequently, both issues become bidirectionally linked to each other.

Info

Please note that if one side of a bi-directional link is removed, the other link will not be automatically deleted.

Note

If a restricted number of issues is set in step 5, it's possible that the reciprocal link could surpass the maximum allowed. In such instances, you will receive a notification, and the backlink will not be established..


Field view and edit

Field edit

The "Select Issue" autocomplete initially offers a selection of recently accessed issues. You can search for issues based on either the summary or the issue key.

Field edit with maximum

In this scenario, the maximum number of issues is set to 1, and backlinks are enabled.

The current issue has reached its maximum limit (indicated by the purple (info)).

But the maximum is also reached in CMSP-21, as it seems to already have another link. This is indicated by the (warning) and a yellow confirm button.

For this example the backlink from CMSP-21 to the current issue won’t be established.

Field view

Linked issues are displayed along with their key, summary, and status. Clicking on the key opens a link to the respective issue in a new tab.


Related Use Cases

Info

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


Jira Service Management (JSM)

Request form: as Jira user

As a Jira user (internal customer), you have the ability to utilize the issue picker within the request form, just as you would in a standard issue form.

Request form: as customer (warning)

As an (external) customer, it is not possible to use the issue picker in the request, regardless of whether the 'skip permission check' setting is enabled.

Portal view

The issue picker links are visible to both internal and external customers.


JQL expression

The Issue Picker field can be accessed like this.

Code Block
${fieldName}.Issues: string[]

Find further information here https://support.atlassian.com/jira-software-cloud/docs/find-specific-issues/

Example: perform a search for all issues that are linked with issue CMSP-19

Code Block
"Issue Picker.Issues" = CMSP-19
Info

The search will find also issues that have multiple links (for example [CMPS-1,CMSP-19])


Data Structure (Automation)

Info

Use custom fields with automation

Note

Maximum issues and JQL restrictions are not taken into account and backlinks are not created when using the Issue Picker with automation.

To set the value via automation, you need to at least set the dueDate value. timeLeft and formattedTimeRange are set on the next rendering step in the issue view

Code Block
{
  "keys": string[]
}

Example: The current issue is linked with two issues CMSP-1 and CMSP-19.

Code Block
{
  "keys": ["CMSP-1", "CMSP-19"]
}
Appanvil karma designer
summary We Are Here To Help Live Demo Reach out to our product team to explore how we can turn your use case into reality together. SCHEDULE FOR FREE Support Our dedicated team is here to assist you with any questions or challenges you may encounter. CONTACT US Feature Request Got an idea for a custom field, a new feature or a particular use case? We're delighted to hear about it! SUBMIT YOUR IDEA Happy? Please let the community know! If you're enjoying your experience with Awesome Custom Fields, we'd love to hear about it! Your feedback helps us grow and improve. RATE US ON THE ATLASSIAN MARKETPLACE
page{"premium":true,"name":"page","children":[{"params":{"background":"#ffffffdb","padding":25,"gap":10},"children":[{"name":"row","children":[{"name":"column","children":[{"name":"text","params":{"value":[{"type":"paragraph","children":[{"type":"paragraph","children":[{"text":"We Are Here To Help","fontFamily":"unset","fontWeight":700,"fontSize":28,"color":"#061D28","letterSpacing":-1}],"align":"center"}]}]},"children":[],"id":"kWu6dge9G0gVC5soph63Y"}],"params":{"borderRadius":{"all":0,"btl":0,"bbl":0,"btr":0,"bbr":0,"isIndividualCorners":false},"padding":0,"gap":20,"verticalAlignment":"center"},"id":"TA7C-YTgUAGxaY7Ee1gRb"},{"name":"column","children":[],"params":{"borderRadius":{"all":0,"btl":0,"bbl":0,"btr":0,"bbr":0,"isIndividualCorners":false},"padding":0,"gap":20,"verticalAlignment":"center"},"id":"3i3tuA9baYMqpBLTOLUVc"},{"name":"column","children":[],"params":{"borderRadius":{"all":0,"btl":0,"bbl":0,"btr":0,"bbr":0,"isIndividualCorners":false},"padding":0,"gap":20,"verticalAlignment":"center"},"id":"h6cp_tv_STHfWn5o3lxmV"},{"name":"column","children":[],"params":{"borderRadius":{"all":0,"btl":0,"bbl":0,"btr":0,"bbr":0,"isIndividualCorners":false},"padding":0,"gap":20,"verticalAlignment":"center"},"id":"EGTJWjOhl3e0azF9InNKw"},{"name":"column","children":[],"params":{"borderRadius":{"all":0,"btl":0,"bbl":0,"btr":0,"bbr":0,"isIndividualCorners":false},"padding":0,"gap":20,"verticalAlignment":"center"},"id":"_aGWOlhpSc1ZY65NzVdAm"},{"name":"column","children":[],"params":{"borderRadius":{"all":0,"btl":0,"bbl":0,"btr":0,"bbr":0,"isIndividualCorners":false},"padding":0,"gap":20,"verticalAlignment":"center"},"id":"9giTj4HKBu8xiguLdZzzj"}],"params":{"layout":[1],"gap":95,"minHeight":100,"padding":0,"borderRadius":0},"id":"8WDed0wGD_SmsvGJ2_kN1"},{"name":"row","children":[{"name":"column","children":[{"name":"card","params":{"gap":5,"padding":40,"borderRadius":{"all":25,"isIndividualCorners":false,"bbl":0,"bbr":0,"btl":0,"btr":0},"background":"#061D280d","hover":"none","isMediaFullSize":true},"children":[{"name":"icon","params":{"shape":"none","color":"#592360","alignment":"center","size":40,"icon":"message"},"children":[],"id":"Z1Y44UTZStMftN5ADWiVY"},{"name":"spacer","params":{"space":0},"children":[],"id":"677H5JgBfLb8m28Mtebd4"},{"name":"text","params":{"value":[{"type":"paragraph","align":"center","children":[{"fontWeight":700,"text":"Live Demo","fontFamily":"unset","letterSpacing":-1,"color":"#061D28","fontSize":24}]}]},"children":[],"id":"mpRVFLlCI25vevGb3eJCv"},{"name":"spacer","params":{"space":0},"children":[],"id":"8XXoV2IrTUIn8gdAR7Hl1"},{"name":"text","params":{"value":[{"type":"paragraph","children":[{"text":"Reach out to our product team to explore how we can turn your use case into reality together.","lineHeight":"22px","fontSize":16,"fontWeight":300,"fontFamily":"unset","color":{"light":"#061D28bf"}}],"align":"center"}]},"children":[],"id":"bWSJwQIvn3Ie-4z6u4yYf"},{"name":"spacer","params":{"space":10},"children":[],"id":"kIzR6deJ2rDxjfzPYiYPO"},{"name":"button","params":{"label":"SCHEDULE FOR FREE","size":"medium","shape":"rounded","alignment":"center","states":{"idle":{"colors":{"background":{"light":"#592360"},"label":"#ffffff"}},"hover":{"colors":{"background":"#061D28","label":"#ffffff"}}},"link":{"value":"https://seibert.biz/acf-jira-demo","target":"_blank","type":"link"}},"children":[],"id":"Q9dYEVl9px0gdQ1WnYKX8"}],"id":"2Po0kyK2zYZXZqa9LqP0o"}],"params":{"borderRadius":{"all":0,"btl":0,"bbl":0,"btr":0,"bbr":0,"isIndividualCorners":false},"padding":0,"gap":20,"verticalAlignment":"top"},"id":"qqolZyQAzfI5BSIxawq_4"},{"name":"column","children":[{"name":"card","params":{"gap":5,"padding":40,"borderRadius":{"all":25,"isIndividualCorners":false,"bbl":0,"bbr":0,"btl":0,"btr":0},"background":"#061D280d","hover":"none","isMediaFullSize":true},"children":[{"name":"icon","params":{"shape":"none","color":"#592360","alignment":"center","size":40,"icon":"video"},"children":[],"id":"iKb4T95bSuayqtVU2WvT2"},{"name":"spacer","params":{"space":0},"children":[],"id":"C9E-5DbXFfOePqxgaVv59"},{"name":"text","params":{"value":[{"type":"paragraph","align":"center","children":[{"fontWeight":700,"text":"Support","fontFamily":"unset","color":"#061D28","letterSpacing":-1,"fontSize":24}]}]},"children":[],"id":"42fnG42m1q63TAHqlatD8"},{"name":"spacer","params":{"space":0},"children":[],"id":"Up3Dlqu3WzfWUFEHhDzzQ"},{"name":"text","params":{"value":[{"type":"paragraph","align":"center","children":[{"lineHeight":"22px","fontSize":16,"fontWeight":300,"fontFamily":"unset","color":{"light":"#061D28bf"},"text":"Our dedicated team is here to assist you with any questions or challenges you may encounter."}]}]},"children":[],"id":"RdMlkf8DDAywMUhigVewc"},{"name":"spacer","params":{"space":10},"children":[],"id":"VjOP2jLer2IJDhjjFrkh4"},{"name":"button","params":{"label":"CONTACT US","size":"medium","shape":"rounded","alignment":"center","states":{"idle":{"colors":{"background":"#592360","label":"#ffffff"}},"hover":{"colors":{"background":"#061D28","label":"#ffffff"}}},"link":{"value":"https://seibert.biz/acf-support","target":"_blank","type":"link"}},"children":[],"id":"zWdNPa1-8fPFrITd5CRWQ"}],"id":"sdFCdxMvutzMPkQrayBRo"}],"params":{"borderRadius":{"all":0,"btl":0,"bbl":0,"btr":0,"bbr":0,"isIndividualCorners":false},"padding":0,"gap":20,"verticalAlignment":"top"},"id":"cRM7MP2uZbvz8GDQqBk4O"},{"name":"column","children":[{"name":"card","params":{"gap":5,"padding":40,"borderRadius":{"all":25,"isIndividualCorners":false,"bbl":0,"bbr":0,"btl":0,"btr":0},"background":"#061D280d","hover":"none","isMediaFullSize":true},"children":[{"name":"icon","params":{"shape":"none","color":"#592360","alignment":"center","size":40,"icon":"lightbulb"},"children":[],"id":"E3plCsiLcHFR7kdTZ3uh0"},{"name":"spacer","params":{"space":0},"children":[],"id":"aFplX1cwDLXAhvY46q-W2"},{"name":"text","params":{"value":[{"type":"paragraph","align":"center","children":[{"fontWeight":700,"text":"Feature Request","fontFamily":"unset","fontSize":24,"color":"#061D28","letterSpacing":-1}]}]},"children":[],"id":"BcuoiAmvhSjjm22Xlx-Zi"},{"name":"spacer","params":{"space":0},"children":[],"id":"5SPT1m3nSbGpRkzUSGkNQ"},{"name":"text","params":{"value":[{"type":"paragraph","children":[{"text":"Got an idea for a custom field, a new feature or a particular use case? We're delighted to hear about it!","lineHeight":"22px","fontSize":16,"fontWeight":300,"fontFamily":"unset","color":{"light":"#061D28bf"}}],"align":"center"}]},"children":[],"id":"FXZlRMJIo04iEApkTJ5uf"},{"name":"spacer","params":{"space":10},"children":[],"id":"G0aEXlwfOQg5pPmdG769l"},{"name":"button","params":{"label":"SUBMIT YOUR IDEA","size":"medium","shape":"rounded","alignment":"center","states":{"idle":{"colors":{"background":"#592360","label":"#ffffff"}},"hover":{"colors":{"background":"#061D28","label":"#ffffff"}}},"link":{"value":"https://seibert.biz/acf-jira-canny","target":"_blank","type":"link"}},"children":[],"id":"TndEd3qGeLVoOfTV-UK0M"}],"id":"vJKyOjRwZT793hiF3jpaW"}],"params":{"borderRadius":{"all":0,"btl":0,"bbl":0,"btr":0,"bbr":0,"isIndividualCorners":false},"padding":0,"gap":20,"verticalAlignment":"top"},"id":"Vcp-xCpiaOJ1OgpCcUmrK"},{"name":"column","children":[],"params":{"borderRadius":{"all":0,"btl":0,"bbl":0,"btr":0,"bbr":0,"isIndividualCorners":false},"padding":0,"gap":20,"verticalAlignment":"top"},"id":"U2x4wTqqD7e8zKQGsJMit"},{"name":"column","children":[],"params":{"borderRadius":{"all":0,"btl":0,"bbl":0,"btr":0,"bbr":0,"isIndividualCorners":false},"padding":0,"gap":20,"verticalAlignment":"top"},"id":"w-pJgS03czaf-7VsNnicx"},{"name":"column","children":[],"params":{"borderRadius":{"all":0,"btl":0,"bbl":0,"btr":0,"bbr":0,"isIndividualCorners":false},"padding":0,"gap":20,"verticalAlignment":"top"},"id":"goqg8VQFURBruWHQix_u9"}],"params":{"layout":[1,1,1],"gap":30,"minHeight":200,"padding":10,"borderRadius":0},"id":"ttMxbhfEeDSEE5J9b1ylq"},{"name":"row","children":[{"name":"column","children":[{"name":"card","params":{"gap":5,"padding":40,"borderRadius":{"all":25,"isIndividualCorners":false,"bbl":0,"bbr":0,"btl":0,"btr":0},"background":"#F4A638","hover":"none","isMediaFullSize":true},"children":[{"name":"text","params":{"value":[{"type":"paragraph","children":[{"type":"paragraph","children":[{"text":"Happy? Please let the community know!","fontFamily":"unset","fontWeight":700,"color":"#FFFFFF","fontSize":28,"letterSpacing":-1,"color":"#061D28"}],"align":"center"}]}]},"children":[],"id":"FEw7soDxxpAUoLhcd9h2L"},{"name":"spacer","params":{"space":10},"children":[],"id":"ZJFO7V_OyKEr9aqQpqjf_"},{"name":"text","params":{"value":[{"type":"paragraph","children":[{"type":"paragraph","align":"center","children":[{"lineHeight":"22px","fontFamily":"unset","color":"#FFFFFF","fontWeight":300,"text":"If you're enjoying your experience with Awesome Custom Fields, we'd love to hear about it! Your feedback helps us grow and improve.","fontSize":16,"color":"#061D28"}]}]}]},"children":[],"id":"fis3eCnZ4Rk06ocER71aI"},{"name":"spacer","params":{"space":10},"children":[],"id":"lu9ZtKSJwVKaQJPzC4nF8"},{"name":"button","params":{"label":"RATE US ON THE ATLASSIAN MARKETPLACE","size":"medium","shape":"rounded","alignment":"center","states":{"idle":{"colors":{"label":"#061D28","background":"#FFFFFF"}},"hover":{"colors":{}}},"icon":"atlassian","link":{"value":"https://seibert.biz/acf-jira-review","target":"_blank","type":"link"}},"children":[],"id":"EY2XBenZv6D87mKtPV1P9"}],"id":"XY5jSIYepg1dSLnlYX_DI"}],"params":{"borderRadius":{"all":0,"btl":0,"bbl":0,"btr":0,"bbr":0,"isIndividualCorners":false},"padding":0,"gap":20,"verticalAlignment":"top"},"id":"KFn73jQI2GT_KYb3ObEFy"},{"name":"column","children":[],"params":{"borderRadius":{"all":0,"btl":0,"bbl":0,"btr":0,"bbr":0,"isIndividualCorners":false},"padding":0,"gap":20,"verticalAlignment":"top"},"id":"aNF1fisyXhPE46rSL_Dcp"},{"name":"column","children":[],"params":{"borderRadius":{"all":0,"btl":0,"bbl":0,"btr":0,"bbr":0,"isIndividualCorners":false},"padding":0,"gap":20,"verticalAlignment":"top"},"id":"zgolu1bSBaJkCWExZ2ZNG"},{"name":"column","children":[],"params":{"borderRadius":{"all":0,"btl":0,"bbl":0,"btr":0,"bbr":0,"isIndividualCorners":false},"padding":0,"gap":20,"verticalAlignment":"top"},"id":"q81-aXYsVxiqUuHX8YeZb"},{"name":"column","children":[],"params":{"borderRadius":{"all":0,"btl":0,"bbl":0,"btr":0,"bbr":0,"isIndividualCorners":false},"padding":0,"gap":20,"verticalAlignment":"top"},"id":"9ey56XpyhDK4P8mR0hgZ1"},{"name":"column","children":[],"params":{"borderRadius":{"all":0,"btl":0,"bbl":0,"btr":0,"bbr":0,"isIndividualCorners":false},"padding":0,"gap":20,"verticalAlignment":"top"},"id":"O7forrBOsWYxlm3Akj6lw"}],"params":{"layout":[1],"gap":10,"minHeight":200,"padding":10,"borderRadius":0},"id":"qdowOjlJr1wH8GsbFPLpY"},{"name":"row","children":[{"name":"column","children":[],"params":{"borderRadius":{"all":0,"btl":0,"bbl":0,"btr":0,"bbr":0,"isIndividualCorners":false},"padding":0,"gap":20,"verticalAlignment":"top"},"id":"ya1QFmMoDBOLD-iC7rr4R"},{"name":"column","children":[],"params":{"borderRadius":{"all":0,"btl":0,"bbl":0,"btr":0,"bbr":0,"isIndividualCorners":false},"padding":0,"gap":20,"verticalAlignment":"top"},"id":"emiYPcj7_m0x6UHFHX9B8"},{"name":"column","children":[],"params":{"borderRadius":{"all":0,"btl":0,"bbl":0,"btr":0,"bbr":0,"isIndividualCorners":false},"padding":0,"gap":20,"verticalAlignment":"top"},"id":"lYVjH6TEpYfsS-sPAnc4u"},{"name":"column","children":[],"params":{"borderRadius":{"all":0,"btl":0,"bbl":0,"btr":0,"bbr":0,"isIndividualCorners":false},"padding":0,"gap":20,"verticalAlignment":"top"},"id":"bXpBRoo3xp_HsOUPjwZGN"},{"name":"column","children":[],"params":{"borderRadius":{"all":0,"btl":0,"bbl":0,"btr":0,"bbr":0,"isIndividualCorners":false},"padding":0,"gap":20,"verticalAlignment":"top"},"id":"DP9_7qYIKbNqA-Uyauxnv"},{"name":"column","children":[],"params":{"borderRadius":{"all":0,"btl":0,"bbl":0,"btr":0,"bbr":0,"isIndividualCorners":false},"padding":0,"gap":20,"verticalAlignment":"top"},"id":"K8vjA2q828pLEsByMS7ss"}],"params":{"layout":[1,1,1],"gap":10,"minHeight":100,"padding":10,"borderRadius":0},"id":"LZ2-LqKoaOBoZ-pM6l_SX"}],"name":"section","id":"75I95QtLPK9ThfFXu_B3-"}],"id":"SK_jc3s-_GRiwqh2cB5Tn"}