Complete tasks by finishing their issue
A tracker connection keeps an issue and its Jaah tasks finished together. Move the issue to the done state in Jira, Linear or Backlog, and every Jaah task linked to it is completed. Finish the task in Jaah, and Jaah moves the issue to the done state. Both are set in the Start and finish section of the connection's Mapping tab.
Who can do this: requires the org admin role. Nobody else sees Issue trackers. Anyone the tracker lets change the issue can then finish it, member of your organization or not.
Set it upโ
- In the sidebar, select Settings, then Integrations, then Issue trackers.
- Select the connection's name. Its page opens on Connection.
- Select the Mapping tab and find the Start and finish section.
- In Done state, type the tracker state the issue moves to when its task is done. Leave it empty for Done. In Linear, a name no team has falls back to the team's first completed state.
- Check Done in Jira completes the task (the box is named for your tracker, such as Done in Linear completes the task). It is on unless someone cleared it.
- Select Save. Discard drops your changes instead.
Finish an issue to complete its tasksโ
- Open the issue in the tracker.
- Move it to the done state.
Every Jaah task linked to the issue is completed, even one that is still running, whether the issue started it or someone linked it by hand. Jaah posts each task's outcome on the issue. A start the issue asked for that has not become a task yet is withdrawn. The connection's Events tab lists the move with the outcome Completed and the tasks it completed: see Check what a tracker did with an issue.
Moving the issue out of the done state again changes nothing in Jaah. A task whose pull request already merged is left as it is.
With Done in Jira completes the task cleared, the move completes nothing, and its event's Reason says the setting is switched off.
Finish a task to move its issueโ
When a linked task is done, Jaah moves its issue to the Done state, once no other task linked to the issue is still at work. A task with an open pull request waits for it to merge. A task done without one, marked done by hand or closed as already done, moves the issue at once. This always happens; clearing the check box above does not stop it.
What else Jaah posts on the issue is in Link a project to an issue tracker. Every field on the Mapping tab is described in Issue trackers. To start tasks from issues in the first place, see Jira, Linear or Backlog.