You can define templates in the admin section of our Jira app to define how the fields in our Outlook Add-In will be pre-filled. By default, the template only fills the most standard fields.
description: <BODY>
The body of the email will be filled into the description of the issue or the description-equivalent of the request.summary: <SUBJECT>
The subject of the email will be the summary of the issue.reporter: <SENDER>
This one is a little tricky. See in the dedicated section for <SENDER> below.customfield_*****: <ORGANIZATIONS> (the actual custom field number depends on your instance and is determined accordingly)
If the reporter is found to be an existing customer, the organizations the customer is part of will be pre-filled.
...
| Table of Contents |
|---|
...
Mappings
You can decide how the fields of your issue will be pre-filled by adding a mapping for this specific field. If a mapping is not valid for a field it will in most cases be ignored and should not cause an error.
User specific mappings
<SENDER>
| Anchor | ||||
|---|---|---|---|---|
|
This definitely is the most complicated mapping.
Our Add-In tries to find a matching Jira user or customer by searching for the email address of the email’s sender. If we are able to find an existing Jira user or customer, it will be pre-filled.
Otherwise, if the mapping is associated with the “reporter” field and all of the following are applicable, our Add-In is capable of directly creating a new customer, see also Why do new customers appear in my Jira Service Management instance? .
Have a Jira Service Management project selected.
You have “Request type” enabled. Creating an issue via “Issue type” can never create a customer.
You will see a (new) appear after the email address in the “On behalf of” field.
...
If the tab “Service Portal” is not visible for you, check the following setting in the App Settings.
...
If you are neither in a Service Management project nor have selected a “Request Type” nor have an existing user or customer for this email address, your own Jira user will be pre-filled into the “reporter” field.
<USER>
For User-Picker or Multi-User-Picker only.
Your own user will be pre-filled.
<RECIPIENTS>
For User-Picker or Multi-User-Picker only.
If we are able to find existing Jira users or customers for the email addresses in “To:” and “Cc:” those will be pre-filled.
<ORGANIZATIONS>
For organizations field only. (the actual custom field number depends on your instance and is determined accordingly)
If the reporter is found to be an existing customer, the organizations the customer is part of will be pre-filled.
Email content mappings
<SUBJECT>
For text field or multi-line text field only.
The subject of the email will be pre-filled.
<BODY>
Currently only working for the description field. Planned to be working for custom WYSIWYG editor fields in the future.
The whole body of the email will be pre-filled.
If you disabled the WYSIWYG-Editor in our Outlook Add-In, it will be pre-filled as markup.
<BODY_PLAIN>
For text field or multi-line text field only.
The whole body of the email as plain text will be pre-filled.
Date mappings
<SENTAT>
For Date Picker, DateTime Picker, text field or multi-line text field.
The date the email was sent at will be pre-filled, ISO string for text and multi-line text fields, always including time.
<TODAY>
For Date Picker, DateTime Picker, text field or multi-line text field.
The current date will be pre-filled, ISO string for text and multi-line text fields, always including time.
<TODAY> + x
For Date Picker, DateTime Picker, text field or multi-line text field.
Offsets the current date by x days to the future.
The offset date will be pre-filled, ISO string for text and multi-line text fields, always including time.
Concatenations of mappings
Mappings can be combined by simply entering multiple to the same field.
The most popular example would be
...
Mappings that are valid for Text fields can also be included in text.
...
Enabling multiple contexts
...