Periods

Period restrictions are only enforced when performing operations using WorklogPRO UI. Using Jira’s REST API or by using other techniques, users may bypass restrictions. Worklogs are Jira’s own entities and Jira only controls its own built-in permissions. Technically there is no way to fully limit worklog operations as long as you use Jira’s own worklog entities.

Timesheet periods allows you to disable timesheet entry for specific date ranges. They are global and configuring periods require Jira administrator permission. Periods are mostly used to prohibit changing of old worklog records but you can also prohibit entering worklogs for future dates if you want. Users are not allowed to log work for closed periods. Administrators can open and close periods clicking on the lock/un-lock icon.

timesheet_period_table.jpg

Global Restrictions

In addition to individual periods, there is also a global restriction to prohibit worklogs in past or future days on the periods page. These settings prevent worklogs regardless of the period state if they are too far in the future or past. You can click the 'Settings' button to configure how many days forward or backward from today the worklog can be added. Global restrictions are optional; if you clear all values and save them as empty, these global restrictions are completely removed. You are not required to define periods; you can only use the global limits. Let's assume you are using monthly periods, and May 2024 is open for worklogs, and we are on the 20th of May. According to the timesheet period settings below, users will not be able to log work for days older than the 6th of May, and they will not be able to log work for days after May 27th.

timesheet-periods-global-settings.jpg

Add New Period

You can add a new period whenever you want, but timesheet periods can't intersect with each other. Start date and end date are inclusive. Timesheet periods are also timezone independent. You can also set an auto lock period that will be locked after the defined number of days.

Locking Period

You can lock a timesheet period by clicking on "lock icon" corresponding to period. If a timesheet period is locked no one can add/delete/modify worklogs in that period. If you need to fix a worklog in a period, Jira administrator should open the period for you.

Automatic Creation of Periods

You may want to add period to the timesheet automatically.You can do this by using the dialog opening by ‘Generate’ button located in the periods page. There are three options for Interval which are weekly, daily and monthly. In the ‘weekly' option, first of all, you need to specify ‘period start’ and ‘period end'. After selecting 'Weekly’ interval, you need to enter a number to 'weeks' part for the date range you set. If you specify '1' for this part, it will create a period for every week in the date range you enter. If you specify 2, it will create a periods with 2 weeks length (14 days). When the selected date range doesn't encompass a complete week, such as spanning over more than one week, the system automatically generates two periods (2 weeks) to accommodate that interval. 'Monthly' and 'Daily’ options are the same as 'Weekly' option that is mentioned above.

Giving Extra Time

Giving extra time allows a specific users to be able to log work for a period in a specified extra time. For example, if the period is closed and user forgot to log work for this period, instead of opening a whole period, a certain period of time from the end of this period is given to this user so that user can log work within this given time. The giving extra time dialog is opened by clicking on the three dots on the line of the relevant period and clicking on the 'Give Extra Time' option. Users who are given extra time for the relevant period are shown in the form of a table in the give extra time dialog. Jira admins can remove or change user's given time.

Exemption for Restrictions

If you need to exempt certain project-based users from the restrictions regarding entering worklogs for past and future dates as specified in the timesheet period settings and locked period restriction, you can grant them the 'Excluded from period checks' permission from the 'Permissions' page within the relevant project.In this way, these users can add worklogs for the date they want for the relevant project.

Â