mattstates / jqtr

Jira Query Time Remaining - See table view for tasks in a JQL query result: Time Remaining, Assignees, Status, Resource Group, Resource Queue, Unestimated Tasks, Key Tasks, Various Warnings, Time In Status

JQTR Version 2.1.0

JQTR: Jira Query Time Remaining

JQTR allows a user to supply a valid JQL (JIRA query language) query and show a table of results to help determine the number of remaining hours left in the result set.

Features

There are two views: Assignee and Initiative.

Assignee View

• Data is organized by each person assigned a task within the query result set.

Initiative View

• Data is organized and aggregated by Jira parent level task.

Core Technologies

• React
• ReactDOM
• React-Table
• webpack
• react-tooltip
• jest
• date-fns

Development

You can transpile the code by cloning the repo and running the following commands in the terminal.

npm install
npm start

or you can run a local dev server environment with

npm run dev

Then you would want to create html tags to link to localhost to request the .js and .css files. (see the Deployment section below for a similar example of this)

You will need a div with an id of jqtrapp to serve as the React entrypoint

<div id="jqtrapp"></div>

Deployment

The best way to use this app would be to compile your code changes with

npm run build

Then drop the index.css and index.js files into the production folder:

\\~\custom\JQTR

Within a Confluence page add a HTML macro and drop this markup into it:

<link rel="stylesheet" href="/custom/JQTR/index.css">
<div id="jqtrapp">
    ...LOADING
</div>
<script src="/custom/JQTR/index.js"></script>

Tests

npm run test

Please feel free to contribute.

Release Notes

2.1.0

• Use React-Tooltip to style hover data
• Update NPM dependencies
• Extract the App component and convert to use React hooks
• Reduce the API data requested to increase speed
• Add a percent-complete component (Parent level shows aggregate percent complete, sub tables show task level percent complete.)
• Display the duration a task has been in its current status
• Show an indication when a total time column has tasks that don't have an estimate
• Add the ability to write and run unit tests (Jest)
• Fixed rounding issue in printHoursPretty fn'

2.0.0

• Convert app from jQuery plugin-based front end to React