Board and list
The tracker page shows one tracker project's issues, either as a board with a column per state or as a table. It is where people find their change approvals and tasks and move them on. What the tracker is and who may do what is on Tracker.
The page header
| Control (label in the UI) | What it does | Shown to |
|---|---|---|
| Create issue | Opens the Create issue dialog (see Creating an issue) | Manual-mode projects only; everyone but auditors |
| New project | Opens the form for a new project (see Two kinds of project) | Company admins, platform admins |
| Gear icon, Project settings | Opens the project's settings (see Workflow and project settings) | Company admins, platform admins |
| Archive icon, Archived projects | Opens the archived projects (see Archived projects) | Company admins, platform admins |
The toolbar
| Control (label in the UI) | What it does | Default |
|---|---|---|
| Project picker | The project shown, listed as name (PREFIX), sorted by name. Archived projects are not listed. The page address carries the project, so a link opens the same board | The first project |
| Search issues... | Shows only issues whose summary contains the text, ignoring case. Issue keys are not searched | Empty |
| My issues | Shows only issues assigned to you | Off |
| Board view / List view | Switches between the board and the table | Board view |
| Filter by state | List view only: All states or one state | All states |
| N issues | The number of issues on the board, with the search and My issues applied |
Search, My issues and the view are not remembered: they start again from their defaults when the page is opened.
Board view
The board has one column per state of the project, in the order the states have in the project's settings.
Columns
Each column shows:
- a dot in the state's colour, the state's name and the number of issues in that state;
- the issues, the most recently changed first;
- No issues when it has none (Drop here while a card that may move there is dragged).
Two limits apply to what a column shows:
| Limit | Effect |
|---|---|
| States of the category Done | Only issues changed within the last 24 hours are shown and counted. Older ones are still found in the list view |
| 50 issues at a time per column | The 50 most recently changed first. Load more below the column shows the next 50, as often as there are more. The number in the header counts all of them |
Cards
| Part of a card | What it shows |
|---|---|
| Key | The issue key, for example CHG-12 |
| Type | The issue type, for example Change approval |
| Summary | The first two lines of the summary |
| Assignee | Initials and name of the assignee, or Unassigned |
| Link icon | Only for a change approval: opens its merge request in the VCS (Open merge request for CHG-12) |
Selecting a card opens the issue page.
Moving a card
A card can be dragged to another column. While it is dragged, the columns it may move to (the moves the project's workflow allows from its state) are outlined; it cannot be dropped anywhere else. Dropping it moves the issue, exactly as Move to on the issue page does:
- when the target state needs fields that are still empty, the Required fields dialog opens first (see Required fields);
- moving a change approval to an approving or rejecting state is a decision, which only its assignee may make (see Who decides a change approval); anyone else gets the reason in an error message;
- Moved to STATE confirms the move; when someone else changed the issue meanwhile, Issue was modified by another user, refreshing... is shown and the board reloads.
Auditors only read the board: their cards cannot be dragged.
List view
The list view is a table of all the project's issues (not archived), 25 per page, the most recently changed first:
| Column (label in the UI) | What it shows |
|---|---|
| Key | The issue key |
| Summary | The summary, on one line |
| Type | The issue type |
| State | The state, in its colour |
| Assignee | The assignee's display name, or Unassigned |
| Updated | When the issue last changed |
Below the table: N issues total, Previous page, Page X of Y, Next page. Changing the search, My issues or the state filter goes back to page 1. Unlike the board, the list view shows issues in Done states however old they are. Selecting a row opens the issue page.
With no match the table says No issues found (Try a different search or filter.).
Empty pages
| Message | When |
|---|---|
| No tracker projects yet (Issues are created automatically when merge requests are processed.), with Create project for admins | The company has no tracker project that is not archived |
| No issues yet | The board shows no issue. For a manual-mode project: Use "Create issue" to add one.; for a VCS-mode project: Issues are created automatically when merge requests are processed. |
API
GET /api/v1/mptracker/projects/{id}/board:columns[](each withstate,issues,total,has_more) andtotal. Query:q(summary contains, ignoring case),issue_type,assigned_to_me=trueorassignee(a user name),limit_per_state(1 to 200, default 50). For a column's next page,state(the column's state: only that column is returned) andoffset(how many of its issues are shown already). Columns of Done-category states hold only issues changed in the last 24 hours.GET /api/v1/mptracker/projects/{id}/issues: the list, newest change first, withpage,page_size(default 50, at most 200) and the same filters plusstate. The answer'smetaholdspage,page_size,total,total_pages.