Exercise 2 - How to Populate the Links of Your Issue and Print a Message When There's None

In this exercise, you'll learn how to populate the Issue Links on an Xporter-generated file. The mappings in use are documented here.

The section between #{for links} and #{end} will grow dynamically according to the number of existing Links on the Issue. In order to begin iterating the Issue Links, at the beginning of the iteration section of your template, put the mapping #{for links}. At the end of that section on your document, put the mapping #{end} to close it.

Since you're iterating, put Links[n]. at the beginning of the mapping of the Link Field you're trying to populate. 

When using the #{for links} statement, the variable name will always be n. If you want to use a different variable name, like b, start your iteration with the statement #{for b=LinksCount} and make sure to change it properly on the Links[b]. at the beginning of the mapping of the Link Field you're trying to populate. 

#{for links}
   ${Links[n].AppType}
   ${Links[n].LinkType}
   ${Links[n].Key}
   ${Links[n].Summary}
   ${Links[n].URL}
#{end}
 
or
 
#{for <VariableName>=LinksCount}
   ${Links[VariableName].AppType}
   ${Links[VariableName].LinkType}
   ${Links[VariableName].Key}
   ${Links[VariableName].Summary}
   ${Links[VariableName].URL}
#{end}

You can use a Conditional Block #{if...} to decide whether to iterate or not.

If the issue doesn't have Links, you can set a message to be displayed instead.

#{if (%{'${LinksCount}' == 0})}
Doesn't have links.
#{end}

If the issue has Links, you can set the message to display the number of Links, along with the Links Iteration.

#{if (%{'${LinksCount}' > 0})}
There are ${LinksCount} links.
#{for links}
AppType: ${Links[n].AppType}
LinkType: ${Links[n].LinkType}
Key: ${Links[n].Key}
Summary: ${Links[n].Summary}
URL: @{title=${Links[n].URL}|href=${Links[n].URL}}
#{end}
#{end}

If you want to display your Links Iteration as a Table, put the Conditional Block above the Header:

#{if (%{'${LinksCount}' == 0})}
No have links.
#{end}
#{if (%{'${LinksCount}' > 0})}
There are ${LinksCount} links.

Then, the Links table Header:

Below it, put the #{for links} or #{for <VariableName>=LinksCount} statement, so the Header is printed only once.

Then, create another table where the Issue Links will be populated:

Finally, close the Links statement using the mapping #{end} and the Conditional Block statement with another #{end}.

#{end}
#{end}

Below is a sample of how the mappings will be displayed in a Word template:

Below is a sample of how the generated file will be populated:

or