Skip to main content

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 doesShown to
Create issueOpens the Create issue dialog (see Creating an issue)Manual-mode projects only; everyone but auditors
New projectOpens the form for a new project (see Two kinds of project)Company admins, platform admins
Gear icon, Project settingsOpens the project's settings (see Workflow and project settings)Company admins, platform admins
Archive icon, Archived projectsOpens the archived projects (see Archived projects)Company admins, platform admins

The toolbar​

Control (label in the UI)What it doesDefault
Project pickerThe 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 boardThe first project
Search issues...Shows only issues whose summary contains the text, ignoring case. Issue keys are not searchedEmpty
My issuesShows only issues assigned to youOff
Board view / List viewSwitches between the board and the tableBoard view
Filter by stateList view only: All states or one stateAll states
N issuesThe 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:

LimitEffect
States of the category DoneOnly 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 columnThe 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 cardWhat it shows
KeyThe issue key, for example CHG-12
TypeThe issue type, for example Change approval
SummaryThe first two lines of the summary
AssigneeInitials and name of the assignee, or Unassigned
Link iconOnly 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
KeyThe issue key
SummaryThe summary, on one line
TypeThe issue type
StateThe state, in its colour
AssigneeThe assignee's display name, or Unassigned
UpdatedWhen 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​

MessageWhen
No tracker projects yet (Issues are created automatically when merge requests are processed.), with Create project for adminsThe company has no tracker project that is not archived
No issues yetThe 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 with state, issues, total, has_more) and total. Query: q (summary contains, ignoring case), issue_type, assigned_to_me=true or assignee (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) and offset (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, with page, page_size (default 50, at most 200) and the same filters plus state. The answer's meta holds page, page_size, total, total_pages.