Edit Fields Variable Expansion in JIRA Automation Plugin

JIRA Automation Plugin, the Edit Fields screen mentions

 

If you allow variable expansion, you are able to manipulate fields in a more dynamic way.
  • You can use the default fields, like: $issue.summary, $issue.description and $issue.assignee.name
  • You can use custom fields, by providing their ID, for example: $customfields.get(10000)
  • To assign a value to a customfield, you can use: customfield_10000=Example: $issue.summary
  • To prepend a value from a customfield before the summary, you could do use: summary=$customfields.get(10000) $issue.summary
  • Text and number fields are currently the only supported custom fields

Where can I get a full list of these variables? This looks to be very handy.

2 answers

1 accepted

2 votes
Accepted answer

We are inserting the whole issue object into the Velocity renderer. Most of built-in fields should work (such as priority etc). You may be able to use similar variables as in email templates. Even branching is possible, same as in other Velocity files.

@Matej Konecny

Thank you for the response.  

Objects that are referable by JIRA Automation Plugin

I'm not a programmer, but I think I the two "objects" that JIRA Automation Plugin sets are issue and custom fields (basically, those are additional fields for issues, in addition to the built-in fields).

EditIssueAction.java Excerpt:

        context.put("issue", issue);
        context.put("customfields", new CustomFieldValueRetriever(customFieldManager, issue));

 

Issue Fields

Are these the places to find the built-in fields?

Branching

What is branching? Is that like $issue.reporter? In fact, what I am trying to do is get to a reporter's group, or a reporter's custom properties. I will post that question separately. Thanks again.

 

 

0 votes

Fields

The issue object is passed as a GenericValue (GV) and Velocity uses public Getters to derive appropriate method similar to the logic here:

issue.getSummary() -> $issue.summary
issue.getPriority().getName() -> $issue.priority.name (I think, never tested)

Basically, object of type https://docs.atlassian.com/jira/latest/com/atlassian/jira/issue/MutableIssue.html is passed, so in theory all methods starting with get* should work.

Branching

You can use standard Velocity formatting template, look at this:

customfield_14080=#if($customfields.get(14080) == 'Urgency 5')13080#elseif($customfields.get(14080) == 'Urgency 4')13081#elseif($customfields.get(14080) == 'Urgency 3')13082#elseif($customfields.get(14080) == 'Urgency 2')13083#end

Make sure it's on one line though smile

Suggest an answer

Log in or Sign up to answer
Community showcase
Published Tuesday in Bitbucket

Upgrade Best Practices

Hello! My name is Mark Askew and I am a Premier Support Engineer for products Bitbucket Server/Data Center, Fisheye & Crucible. Today, I want to bring the discussion that Jennifer, Matt, and ...

186 views 3 6
Read article

Atlassian User Groups

Connect with like-minded Atlassian users at free events near you!

Find a group

Connect with like-minded Atlassian users at free events near you!

Find my local user group

Unfortunately there are no AUG chapters near you at the moment.

Start an AUG

You're one step closer to meeting fellow Atlassian users at your local meet up. Learn more about AUGs

Groups near you