Page tree

You are on the Xporter Server documentation. If you are looking for Xporter Cloud documentation, you can find it in this page.

Skip to end of metadata
Go to start of metadata

Xporter for Jira allows you to get the billed hours and attributes from each worklog entry, a field generated by and managed from the Tempo Timesheets add-on.

The steps described here are only required for Tempo Timesheets 8.x.x.


Xporter for Jira integrates with Tempo Timesheets via the Tempo Servlet API and Tempo REST API

Configuration

  1. Get the access token to allow Xporter for Jira to communicate with Tempo Timesheets. (See here for more information.)
    1. Define the access token in your document using the Prop function. The key must be: tempo.api.token.
  2. Define Tempo to export Billed hours.
         a.  Go to Tempo Administration -> Fields -> Custom Fields and check the Export billed hours option.

Example

This lists the billed hours by each worklog entry.

${prop(tempo.api.token,f66a8d4f-5b77-44d2-8973-944d643b0235)}
#{for worklogs}
   Author: ${Worklogs[n].Author}
   Comment: ${Worklogs[n].Comment}
   Time Spent: ${Worklogs[n].TimeSpentFormatted} 
   Billed hours: ${Worklogs[n].BilledHoursFormatted}
#{end}


This lists the attributes by each worklog entry.

This functionality requires Tempo Timesheets 8.13.1

#{for worklogs}
   Author: ${Worklogs[n].Author}
   Comment: ${Worklogs[n].Comment}
   Time Spent: ${Worklogs[n].TimeSpentFormatted} 
   Attribute: ${Worklogs[n].My Attribute Name}
#{end}


Additional configuration

Xporter allows you to define the interval of Worklogs you want to get on your reports.

The only information you will need to add in the template is the date you want to get the work logs.

  1. You are able to define the date from and the date to on your document using the Prop function

    KeyValue
    tempo.api.fromEx.: 2018-01-01
    tempo.api.toEx.: 2018-12-31

Please be aware that both dates should have the following format: "yyyy-MM-dd".

${prop(tempo.date.from, 2018-01-01)}
${prop(tempo.date.to, 2018-12-31)}
  • No labels