Summary
You can use the configuration file to configure some of the parameters of Time in Status.
In order to use the configuration file, create a text file named timeinstatus.properties in the Jira Home folder of your Jira server.
When you make changes on the configuration file, you will need to just disable/re-enable Time in Status app for the changes to take effect.
Restarting Jira also works as a disable/enable operation but it is not needed.
Disabling Report Types
By default, all reports are available to users. You can use the configuration file to disable one or more of Time in Status Report Types.
When a report type is disabled, that type will not appear in the user interface and Time in Status REST API will reject report requests of that type.
Put the following properties in the file:
timeinstatus.reporttypes.statusduration.enabled = true timeinstatus.reporttypes.durationbetweenstatuses.enabled = true timeinstatus.reporttypes.assigneeduration.enabled = true timeinstatus.reporttypes.statusdurationbyassignee.enabled = true timeinstatus.reporttypes.assigneedurationbystatus.enabled = true timeinstatus.reporttypes.groupduration.enabled = true timeinstatus.reporttypes.groupdurationbystatus.enabled = true timeinstatus.reporttypes.statusdurationbygroup.enabled = true timeinstatus.reporttypes.statuscount.enabled = true timeinstatus.reporttypes.transitioncount.enabled = true timeinstatus.reporttypes.firsttransitionfromstatusdate.enabled = true timeinstatus.reporttypes.lasttransitionfromstatusdate.enabled = true timeinstatus.reporttypes.firsttransitiontostatusdate.enabled = true timeinstatus.reporttypes.lasttransitiontostatusdate.enabled = true timeinstatus.reporttypes.anyfieldduration.enabled = true
Each property entry in the file corresponds to a report type. Change the value of the property to false for the report types that you want to disable.
Gadget Limits
Issue Limit
By default, Time in Status gadgets will not show reports that need the processing of more than 1000 issues.
To increase or decrease this limit, put the following line in the properties file and set the new limit value.
timeinstatus.gadget.maxissuenumber = 1000
Date Range Limit
By default, Time in Status gadgets will allow you to set a date range with a max value of 365 days.
To increase or decrease this limit, put the following line in the properties file and set the new limit value.
timeinstatus.gadget.maxdaterange = 365
Considering the dashboards are frequently refreshed, the default Issue Limit and Date Range Limit are in place to avoid putting too much load on your Jira server. The effects of having a higher or lower limits depend on ...
- The actual number of Time in Status gadgets used on dashboards
- The number of issues they are configured to process
- Your server capacity.
Use these settings with discretion.