Boards

On this page

A board shows tickets as cards grouped into columns by status, one column for each status value the board shows. Boards are available for four classes: Incidents, Service Requests, Work Orders, and Project Tasks. A board shows one class at a time, and you can switch its class from inside the page. Each card represents a ticket, or, on a Project Tasks board, a task.

A board loads at most 100 cards. Its search covers only those loaded cards; see The 100-card limit.

What you can see and change

Which classes you can put on a board follows which classes you may view: a class is offered on the Boards page only when your security role lets you view it. If none of the four classes is open to you, opening Boards leads to an access-denied page rather than an empty board.

You see a board in the boards list when it is for a class you may view and either you own it or it is shared, whether with everyone or specifically with you or one of your groups.

A few actions need their own right, and the corresponding command is unavailable without it:

  • Creating a board, and exporting or importing one, need the local view management right.
  • Saving changes back to a board needs the right to edit it; sharing it or making it private each need their own right.
  • A default board, the one Alloy Navigator supplies when no board is available to you yet, cannot be edited, hidden, or made private; save your changes to it with Save As instead.
  • A temporary board, the one you make with Apply (see Customize a board), can be edited and saved by anyone it is available to.

In the Web App

Open a board

When you open Boards, you see the board you last had open. Alloy Navigator remembers one board for the Boards page, whichever class it shows. If that board is no longer available to you, Alloy Navigator falls back to a board named for the default board, then to an older default board name, then to the first board in your list.

If no board is available to you yet, Alloy Navigator shows you a default board for the first class you may view. The default board groups by Status and is not stored anywhere; to keep it, save it as your own board with Save As. Each class's default board has its own sort order:

Default board Sorted by
Incidents Due date, descending
Service Requests Due date, descending
Work Orders Submit date, descending
Project Tasks Created date, descending

A board you change with Apply instead of saving it (see Customize a board) is temporary: it exists only for your current sign-in session, nobody else can see it, it does not appear in the boards list, and it is gone once your session ends unless you save it as a permanent board.

Create a board

  1. Click the board name in the header to open the boards list, then choose New.
  2. In the New Board wizard, type a name for the board; you cannot go on without one. If more than one class is enabled for you, choose the class under Select ticket class: Incidents, Service Requests, Work Orders, or Project Tasks. The first class you may view is selected at first. A class you may not view shows disabled rather than being left out.
  3. On Select Columns, choose which status values appear as columns and set their order. All status values are selected at first. The board always groups by status; this step does not change that.
  4. On Filters, set the conditions that decide which tickets appear on the board.
  5. On Sort, choose the sort field and direction. The step starts at the ticket number (for Project Tasks, the created date), descending, when the class has that field. You cannot finish the wizard without a sort field.
  6. On the sharing step, choose Only me, Everyone, or Specific people or groups. Only me is selected at first.
  7. Click Create.

The new board becomes your current board. If you had typed a name or changed the class, closing the wizard from outside it asks Do you want to close?; the close button in the wizard's header, titled Back, closes it without asking.

Customize a board

Click the settings button in the board header to open the Customize Board pane. It opens on the Columns tab and also offers Filter, Sharing, and Sorting.

  • Columns: add any status of the board's class that is not already a column, drag columns to reorder them, and remove a column. Columns cannot be renamed. Any column can be removed, including a column for a system status.
  • Filter: build the board's filter as groups of conditions. Conditions in a group are joined with AND, and groups are joined with OR; a group cannot contain another group, and there is no limit on the number of groups or conditions. With Compare with another field, a condition compares its field with another field instead of a typed value. The tab is the same filter editor that lists use, with the same conditions and operators; see Build a filter.
  • Sharing: choose Only me, Everyone, or Specific people or groups. Under Specific people or groups, pick groups and technicians; the board's owner is always listed and cannot be removed, and the owner's entry is titled "The owner cannot be removed from sharing." Below the sharing choice, the pane shows Board name, Owned by, Last modified, and Modified by, with N/A where a value is missing. Only me is unavailable if you may not make the board private; the other two are unavailable if you may not edit the shared board. An unavailable choice is titled Permission denied.
  • Sorting: pick the sort field and direction. The choice takes effect when you click Save or Apply.

The Reset button in the pane header undoes the changes on every tab at once, without asking. If the open board is a temporary one you made with Apply, Reset also discards the applied changes and returns to your stored board. The Filter tab has no separate way to undo only the filter.

The pane's footer offers:

  • Save: writes your changes back to the current board. It is available once something has changed, the sharing choice is valid, and you may make that particular change (share it, make it private, or otherwise edit it). It is not available on a default board; its tooltip there reads "Default temporary boards cannot be modified. Please use the 'Save As' command instead."
  • Save As: saves your changes as a new board.
  • Apply: shows your edited board without saving it, as a temporary board (see Open a board). It needs a change other than to sharing.

On the Boards page, saving changes over a shared board always opens a choice between saving your changes as your own private copy or updating the shared board; each choice is available only when you hold the right it needs. If your change would remove someone's access to the board, you confirm that separately first.

Sort a board

The sort button in the board header lets you pick the sort field and direction directly, without opening the Customize Board pane. It saves your choice immediately, and it is disabled on a default board or when you may not edit the open board.

Work with cards

Each card shows the ticket number (on a Project Tasks board, the task's ID) as a link, a Due Date row and a planned-end-date row, each only when that date is set, so a card can show both. It also shows the summary, clamped to two lines, the priority, and the assignee's photo, titled "Assignee:" followed by the assignee's name. A card always shows this set of fields, whatever fields the board itself lists. The date rows are colored when the item is overdue, judged by the due date or, when there is none, by the planned end date. A column header shows the status name and, when the column is not empty, its card count.

  • Clicking a card opens it in the in-page preview. Ctrl-clicking (Cmd-clicking on a Mac) or middle-clicking it opens the ticket in a new tab instead.
  • The ... menu on a card is the same row-action menu that the rows of a list use.
  • Clicking a column's header collapses it to a narrow strip with the status name rotated and the cards hidden; clicking again expands it. This state is not remembered: a reload, or a search that hides the column and then shows it again, expands it.
  • The search box above the board filters only the cards already loaded (see The 100-card limit), ignoring case, and columns with no matching cards are hidden while a search term is active.
  • When a workflow action finishes while a board is open, the board reloads itself, its cards, and its list of boards right away, without waiting for you to reload the page.

Manage boards

Click the board's name in the header to open the boards list. It shows your boards with an icon marking each as shared or personal, and a toolbar for the open board:

  • New opens the wizard described in Create a board.
  • Save writes unsaved changes back to the open board when you may edit it; Save As saves them as a new board.
  • Rename is available on a board you may edit that is not temporary.
  • More offers Hide or Unhide, Export Board, Import Board, and Delete; it is unavailable for a default or temporary board.

The boards list has no command for managing shared boards.

New, Export Board, and Import Board all need the local view management right, and Delete needs the right to edit the board. Export Board downloads a .json file named after the class and the board, holding the board's columns, card fields, sorting, filter, and grouping, with the product name and version. Import Board takes such a .json file and refuses a file from another product. Each other listed board has its own menu offering Rename, Hide or Unhide, an export entry, and Delete, under the same rights. Delete asks you to confirm and then reloads the current board.

The 100-card limit

A board shows at most 100 cards, and says so in a warning bar that gives that number. It loads the board's first 100 items from the server and never asks for more, so items past the first 100 are not loaded at all. Because the limit applies to the cards the board has loaded, the search box described in Work with cards searches only those cards.

The board in a Project

On a Project record, the Tasks tab switches between List, Gantt, and Board, and opens on List each time. Board shows a board of that project's tasks, with a button to add a task unless the record is read-only. This board keeps its own state: its current board, unsaved changes, and search text are separate from the Boards page, even in the same browser tab. On this embedded board:

  • When no board is available to you on this tab yet, it shows a default board of the project's tasks, grouped by Status and sorted by created date, descending.
  • The header has no board title and no board switcher; it keeps the add-task button, the sort button, the search box, and the settings button.
  • The Customize Board pane keeps only the Columns and Sorting tabs, and has no Save As button.
  • Saving always creates a new private board for you; it never updates an existing board. Your saved layout for this tab is remembered for you rather than per project, so saving it on one project changes what you see on the Board tab of every other project you open, while other technicians keep their own layout.
  • Cards behave as described in Work with cards; a task's card links by the task's ID and shows its planned end date when one is set.