Formatting Date Fields

If you are exporting a date field such as CreatedDate and LastUpdateDate, you can define the format of how the date is displayed. All the patterns supported by the SimpleDateFormat Java API are supported.

Definition: 

${dateformat("<Format>"):<Field name>}
Expand to see the examples on sample code 
${dateformat("yyyy-MM-dd"):CreatedDate}
${dateformat("EEE, MMM d, ''yy"):CreatedDate}
${dateformat("EEE, d MMM yyyy HH:mm:ss Z"):UpdatedDate}

Formatting Number Field

Available: Xporter for JIRA 3.3.0 and later.

If you are exporting a Number Field, you can define the format of how the number is displayed. All the patterns supported by the DecimalFormat(String pattern) Java API are supported.

You can also specify the Locale you want to use. All the Locales in JRE 7 Supported Locales page are supported.

Definition: 

${numberformat( "<pattern>" ):<Field name>}

${numberformat( "<Locale>" , "<pattern>" ):<Field name>} 

Expand to see the examples on sample code (considering Price as a custom Number Field) 
${numberformat("###,###.###"):Price}
${numberformat("\u20AC ###,###.###"):Price}
${numberformat("de_DE" , "###,###.###"):Price}
${numberformat("##0.#####E0"):Price}
${numberformat("en_UK" , "#0.#####%"):Price}

Formatting User Picker Fields 

In Xporter for JIRA 4 and later displayname and displayemail function were replaced by new functions: fullname and emailaddress.

If you are exporting a User Picker or Multiple Users custom field, you can output the Display Name using the fullname function.

Definition: 

${fullname:<Field name>}
Expand to see the example on sample code 
${fullname:UserCustomField}

 

If you are exporting a User Picker or Multiple Users custom field, you can output the email using the emailaddress function.

Definition: 

${emailaddress:<Field name>}
Expand to see the example on sample code 
${emailaddress:UserCustomField}

Escaping fields

If the fields to be exported need to be escaped there is a function for that. Escaping allows fields with line breaks or other special characters to be used inside Javascript.

Definition:

${escape:<Field name>}
Expand to see the examples on sample code 
${escape:Description}
${escape:Custom Field}
 
%{('${escape:Description}'.length > 0) ? 'This issue has description': 'This issue does not have description'

Creating mappings based on Javascript using formatted fields

There are times when it may be needed to format a field, execute javascript actions on the formatted field, and export the result as HTML or WIKI.
In this cases, all above formatters are available.

 

Expand to see the example on sample code 
${html:%{'${escape:Description}'.replace(new RegExp('toReplace','g'),'replacer')}}
  • No labels