Come for the products,
stay for the community

The Atlassian Community can help you and your team get more value out of Atlassian products and practices.

Atlassian Community about banner
Community Members
Community Events
Community Groups

How Email contents are mapped to the issue fields- what should be the email format


I configured the mail hadler and it works fine i am able to create new issues via email but how do i map the fields what should be the format of the email so the values are written to the correct field

example In the email i need

Summary value should be mapped to Summay field

Type value----> to be mapped to the issue type field

State value---> should be mapped to State field

Functional area value --->should be mapped to Functional area

I did not find any documentation on email formats any one can point me to one if its available ?

Also how do i modify an existing issue via email ? what should be the email format and subject line

In Clearquest mail the email has to be written in certain format so the fields values are written to the correct fields

2 answers

To follow up, JEMH has the capability to update all standard fields in an issue, this can be done through Directives, which are values supplied in specific format, interpreted by JEMH Field Processors. This will work well if a user wants to update issues by email, or if you have a weform somewhere that ends us as email content (eg Confluence MailFormNg).

Examples for formats would be

  • (subject) : A subject #issueType=bug #field="X,this and that"
  • (body, preceeding content) : @issueType=bug

If you have a pre-determined email structure, you can use the JEMH Regexp Field Processor, which uses regular expressions to extract values from a structured email body, and map them to fields you define. I have quite a few organisations using this appraoch to integrate 3rd party systems with JIRA. The RegexpFP also uses some unique key specific to the remote system, stored in a custom field, to locate 'current' issues such that repeat emails become comments on the original (open) issue.

Happy to discuss further.

0 votes

You have not said what email handler you are using.

The default handlers are quite simple - they populate summary from subject, description from the body, and they make some assumptions about reporter, assignee and issue type. That's it, they don't do any more. Your field mappings need something more advanced, so we need to know what handler you might be using before we run off in the wrong direction...

I am using "Create a new issue or add a comment to an existing issue"

No, I'm sorry, I was not clear. What mail handler are you trying/using/looking-at in Jira?

The mail server doesn't matter as long as Jira can read/write it.

Hi I am using POP mailserver. Our mail server is on solaris and we use sendmail hope this helps

Ok, that's a handler that behaves as I described. It won't try to do any field type processing.

You need to find or write a handler that will look for and process your fields. Every time email is part of a question, the answer is pretty much "JEMH" -

If you don't want to do that, I'd have another look through the marketplace, and then think about writing a specific handler for your needs.

Suggest an answer

Log in or Sign up to answer

Community Events

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

Find an event

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

Unfortunately there are no Community Events near you at the moment.

Host an event

You're one step closer to meeting fellow Atlassian users at your local event. Learn more about Community Events

Events near you