1. Managing issue repeats
Add repeating to issue
- Go to issue view
- Select More from issue action navigation bar and then Repeat.
Alternatively go to Repeating Issue section on the right panels and click Set repeating.
- On new Repeating Issue modal panel configure repeating by choosing available repeat action and its related parameters (e.g. Summary, Issue type) and defining how often and how long this action should be executed.
Preview repeating details
Go to issue view and get the repeating info in the right panels in the Repeating Issue section. This section shows:- summary of repeating action and its frequency
- the date when repeating starts
- the date of next occurrence
- the date when this repeating was updated
To see more detailed information about repeating for specific issue go to edit mode.
Edit repeating for issue
- Go to issue view
- Select More from issue action navigation bar and then Repeat.
Alternatively move cursor over Repeating Issue section on the right panels and click edit icon (pencil). - On new Repeating Issue modal panel configure new repeating and click Repeat Issue.
Remove repeating from issue
- Go to issue view
- Move cursor over Repeating Issue section on the right panels and click delete icon (trash)
- On new Delete repeating modal panel confirm deletion.
2. Available actions
- Clone Issue
This action make clone of current issue. Available parameter is cloned issue summary. - Create Sub-Task
This action create sub-task in given issue. Available parameters are sub-task summary and issue type - Issue workflow
This action allow to execute any default and custom workflow on given issue if workflow allow for this transitions. Available paraameters is workflow that should be executed.
3. Scheduling repeating actions
Each repeating action supports recurrence rules as defined in the iCalendar RFC. Repeating Issues for Jira allow to schedule actions that:- starts from given date
- repeats daily, monthly, weekly and yearly
- repeats every n times
- repeats on given day of week
- repeats by day of the month or day of the week
- ends never, after x times, or on given date
4. Searching for issues with recurrence
To search issues with repeating go to Jira issue navigator and use JQL query:issue.property[com.codedoers.issue.recurrence].nextOccurrenceDate is not null
Sometimes it is possible that issue with repeating has empty nextOccurrenceDate. This occurs when:
- recurrence rule is not valid and nextOccurrenceDate can't be calculated
- repeating ends and issue should not be repeated anymore
Then you can use following JQL to search all issues with repeating (including invalid rules and completed recursion):
issue.property[com.codedoers.issue.recurrence].rRule is not null
5. Searching for issues with failed recurrence (from 0.2.0)
To search issues with repeating that failed during last execution go to Jira issue navigator and use JQL query:issue.property[com.codedoers.issue.recurrence.last].hasErrors = 'true'