In case you want to render issue link information in your email, you must edit your email templates. Rendering issue links requires a complex processing logic. The key is $!issue.linkCollection that returns a LinkCollection object if there are linked issues ortherwise null.
Below are example template code fragments that will render issue link information in HTML or TEXT emails.
When selecting "Linked Issues" in the Field Picker dropdown, you will get instructions on how to easily include issue link information in the template.
In case you want a customized display (e.g. include more attributes of the linked issues), then you can start to add these template fragments directly into your templates and customize them according to your needs.
| Note | ||
|---|---|---|
| ||
The LinkCollection will return the linked issues as the email sender sees them. The sender may not be privileged to view all linked issues in JIRA. If this is the case, the email may not list all linked issues either. |
Insert issue links
...
| Code Block | ||||
|---|---|---|---|---|
| ||||
#set ($lc = $!issue.linkCollection)
#if ($!lc)
<tr valign="top">
#if ($!isJIRA61OrLater)
<th><strong style="font-weight:normal;color:${textSubtleColour};">Links:</strong></th>
<td>
#else
<td style="color:${textColour};font-family:${textFontFamily};font-size:${textSize};padding:0 10px 10px 0;white-space:nowrap;"><strong style="font-weight:normal;color:${textSubtleColour};">Links:</strong></td>
<td style="color:${textColour};font-family:${textFontFamily};font-size:${textSize};padding:0 0 10px 0;width:100%;">
#end
#foreach ($linkType in $lc.linkTypes)
#set($outwardIssues = $lc.getOutwardIssues($linkType.name))
#set($inwardIssues = $lc.getInwardIssues($linkType.name))
#if($!outwardIssues && $!outwardIssues.size()>0)
<dl>
<dt><p style="font-weight: bold"></progress>$linkType.outward</p></dt>
#foreach ($outwardLinkedIssue in $!outwardIssues)
<dd>
<div style="display:table;">
<a style='color:${textLinkColour};text-decoration:none;' href='${baseurl}/browse/${outwardLinkedIssue.getKey()}'>$outwardLinkedIssue.getKey()</a>
<span style="white-space: nowrap;">$outwardLinkedIssue.summary</span>
</div>
</dd>
#end
</dl>
$!outwardIssues.clear()
#end
#if($!inwardIssues && $!inwardIssues.size()>0)
<dl>
<dt><p style="font-weight: bold"></progress>$linkType.inward</p></dt>
#foreach ($inwardLinkedIssue in $!inwardIssues)
<dd>
<div style="display:table;">
<a style='color:${textLinkColour};text-decoration:none;' href='${baseurl}/browse/${inwardLinkedIssue.getKey()}'>$inwardLinkedIssue.getKey()</a> <span style="white-space: nowrap;">$inwardLinkedIssue.summary</span>
</div>
</dd>
#end
</dl>
$!inwardIssues.clear()
#end
#end
</td>
</tr>
#end |
...
| title | Render issue link information in TEXT emails |
|---|
...
Thank you for visiting our old product documentation site. Note that we no longer store or update our documentation here.Please navigate to our new documentation site and update your bookmarks accordingly. If you're looking for the former content of this page, click here. |