Dashboards

On this page

A dashboard arranges content in widgets, such as announcements, links, shortcuts to views or create actions, reports, and analytic charts. A dashboard can be private, visible only to you, or shared with everyone or with specific people and groups.

Widgets are created in the Web App. In the Settings App, existing widgets other than Analytic Chart and Counter Group widgets can be edited, and widgets can arrive through a configuration import; see Shared Dashboards and Widgets.

Dashboards in the Web App

What you can see and change

Three permissions control what you can do with dashboards and analytic charts:

Permission What it allows
Manage Personal Dashboards and Charts Create or edit a private dashboard or chart.
Share Dashboards and Charts Create a shared dashboard or chart, and edit a shared one you own.
Manage Shared Dashboards and Charts Create a shared dashboard or chart, and edit any shared one you can see.

You need at least one of these three to use New, Save As, and Customize Dashboard. Save is enabled only when the dashboard isn't a default dashboard and isn't one you're still creating, has unsaved changes, and you're allowed to make the specific change you made: sharing it, making it private, or editing it. A separate Export data permission is described as covering the export of data from analytics charts. See Permissions Reference for the full list of permissions.

Marking a chart to bypass role-based access control needs a separate, higher permission than these; see Role-based access bypass.

Which dashboard loads

The dashboard is your landing page. To return to it from anywhere in the Web App, use My Work > Dashboard in the sidebar. Alloy Navigator opens:

  1. Your active dashboard, which is stored as your preference, if it can still be loaded.
  2. Otherwise, the first dashboard available to you.
  3. Otherwise, a message instead of a layout. Which message you see depends on whether you hold one of the three dashboard permissions.

A link to a specific dashboard, such as one on a widget's Dashboards tab (see Configure a widget), opens that dashboard. If the linked dashboard isn't available to you, the page opens without switching and without a message.

A red banner across the top of the dashboard can show a license-expiry message. Closing it dismisses it for your current session only.

Switch dashboards

  1. Open the dropdown next to the Dashboard title in the page header.
  2. Select the dashboard you want.

The picker's panel also has a toolbar with New, Save, Save As, Rename, and More.

If the dashboard you're leaving has unsaved changes, you're asked whether to save and switch, switch without saving, or cancel. If you close or reload the browser tab with unsaved changes, the browser warns you first.

Edit a dashboard's layout

  1. Click Customize Dashboard in the page header. This opens the Customize Dashboard drawer and puts the dashboard into edit mode. Once you've made a change, the button shows a dot and the tooltip "Dashboard has been modified but not saved."
  2. Use the drawer's Widgets tab to add widgets (see Add a widget), or its Sharing tab to change who the dashboard is shared with (see Share a dashboard).
  3. Move and resize widgets on the layout. You can move or resize a widget only in edit mode, where widgets show a highlighted border and a grab cursor.
  4. To keep your changes, click Save or Save As (see Save changes and Save a copy of a dashboard).

While editing, an undo button appears next to Customize Dashboard once you have a change to undo, and a redo button once you have one to redo. In edit mode you can also press Ctrl+Z to undo and Ctrl+Y or Ctrl+Shift+Z to redo (Cmd on a Mac). The shortcuts don't work while Alt is held or while the focus is in a text box, a list, or another input field; see Keyboard Shortcuts. Undo and redo step through up to 50 recorded states of the layout. Switching to another dashboard clears the history. Undoing every change doesn't clear the dashboard's unsaved-changes state; saving, Reset, or switching to another dashboard does.

The layout has six columns; a widget can't be placed beyond the sixth.

The three-dot menu button in the drawer's header also offers:

  • A submenu for creating a new widget or importing one from a file (see Add a widget and Export and import a widget).
  • Auto-arrange for compact layout, which packs your widgets together automatically, after you confirm.
  • Reset, which asks "Do you want to reset the dashboard?" and, if you confirm, puts the widgets back to the dashboard's last saved layout, clears the dashboard's unsaved-changes state, and leaves edit mode. Reset doesn't reload widget data.

Add a widget

  1. In edit mode, open the drawer's Widgets tab. The palette lists only the widgets you're allowed to use, in groups; an analytic chart is listed under Chart, Counters, or Table according to its kind. To filter the palette, type part of a widget's name in the Text to search for... box.
  2. Drag a widget from the palette onto the layout. A widget that's already on the dashboard is dimmed in the palette and can't be dragged in again until you remove it.

A widget you drop starts at a default size for its type, which you can then resize. It loads its data right away, before you save the dashboard; if the data can't be loaded, the widget is still placed.

To create a new widget instead of reusing an existing one, open the three-dot menu in the drawer's header, open its submenu for new widgets, and choose a type: Announcements, Chart, Counter Group, Counters, Create Actions, Links, Report List, Table, or View. Chart, Counters, and Table open the dialog for creating an analytics widget; the other six open the widget's edit drawer with its settings form (see Configure a widget).

If a widget already placed on a dashboard is one you aren't allowed to use, it still appears on the layout, but as a placeholder with a permission message instead of its content.

Configure a widget

Every widget type with a settings form takes a Title, which is required, plus its own settings:

Widget Settings besides Title Each item includes
Announcements The maximum number of announcements to show, a required whole number, 3 by default -
Create Actions The list of actions The action, and a caption
Links The list of links A link text and a URL, both required
Report List The list of reports The report, and a caption
View The list of views The view, and a caption
Counter Group A comparison toggle, an invert toggle shown when comparison is on, and the list of counters The counter, and a caption
  1. Open the widget for editing in one of these ways:
    • In edit mode, click Edit in the widget's title bar.
    • In the palette, open the widget's Options menu and choose Edit.
  2. On the Settings tab, enter the Title and the type's other settings from the table above.
  3. For a widget with a list of items, click Add. For every type except Links, a picker opens right away: pick a row by clicking its name, double-clicking it, or selecting it and clicking Select. The item dialog's OK stays unavailable until you've picked something. If you close the picker without picking anything while the item dialog is still empty, the dialog closes too. Unless you've already typed a caption, the caption is filled in from the picked name, and you can change it; a View item is named after the object and, in parentheses, the view. An item whose caption you leave empty is saved with the picked name. For a Create Actions item, every pick replaces the caption with the action's name, without a leading "New". The Counter Group's picker lists only counter charts, and only those you can already see. For a Links item, enter a link text and a URL. Click OK.
  4. Drag items to reorder them. To change or take out an item, open its options menu and choose Edit or Remove. Remove takes the item out at once, without asking. Every item needs a caption. An item that duplicates one already in the list is ignored without a message.
  5. Click Save. It's enabled once the title is filled in and something has changed.

If you close the edit drawer with unsaved changes, you're asked to confirm before it closes.

Editing is available for Announcements, Create Actions, Links, Report List, View, Analytic Chart, and Counter Group widgets. For other, older widget types that remain on upgraded dashboards, Edit is disabled; in the palette, its tooltip reads "Legacy widgets cannot be edited."

For an Analytic Chart widget, Edit opens the chart in the chart editor. Opened from the dashboard, the chart editor also has a Dashboards tab when the chart is placed on any dashboard, and saving there saves the chart and reloads the widget. In a Counter Group widget, choosing Edit for a listed counter also opens that counter's chart editor. A dashboard doesn't hold its own copy of a chart: saving a change to the chart changes it on every dashboard that shows it.

With the Counter Group's comparison toggle on, each counter after the first compares its first value with the previous counter's last value, and the invert toggle reverses the color logic of that comparison. No comparison is shown when either value is missing, or when only one of the two counters shows percentages.

If the widget is placed on any dashboard, the edit drawer has a Dashboards tab that lists those dashboards, each as a link that opens it in a new tab. A dashboard you can't open is only counted, not named.

Work with a widget's content

  • Announcements shows up to its maximum number of announcements. Each shows its title, its start date, a flag icon when it's high priority, and its content cut to two lines, with a See details link that opens the announcement in a new tab. When there are more announcements, a More link under the list opens the announcements list in the same tab.
  • View shows every item to everyone who can see the widget. Each item shows its count, or N/A when that view isn't available to you or can't be counted. Clicking an item opens the list with that view in a new tab.
  • Links opens the item's URL in a new tab.
  • Report List opens the report in a new tab. A report you can no longer view is left out of the widget, with no placeholder.
  • Create Actions shows only the create actions your roles allow. Clicking one opens the form for creating the record. A Create Actions widget that holds no actions shows a message in place of the list.
  • On older Table and Latest Activities widgets that remain on upgraded dashboards, double-clicking a row or its details line opens the record, in the current tab, or in a new tab when your setting for opening records in a new tab is on. Their rows don't offer Delete.
  • On an Analytic Chart other than a counter, a strip above the chart holds the chart's date filter and any quick filters. Changing them on the dashboard changes what the widget shows, not the saved chart. Clicking a bar, slice, or other element opens a drill-down popup with the matching rows and an Export button. In the popup, and in a chart shown as a table, a row's link or a double-click on the row opens its record in a new tab. A single click elsewhere on a table's row opens nothing, and a table has no drill-down. Except for a counter, the chart shows no more items than the system's analytics item limit, 50 when that limit isn't set.
  • On every Analytic Chart, counters included, the eye-icon button View details in the title bar opens the chart in the chart editor. It appears outside edit mode, once the chart has loaded. When the chart shows only part of its data, the button's tooltip reads "View details to see full data" and the icon carries a dot.

Refresh widget data

Outside edit mode, each widget's title bar has a Refresh button that reloads that widget alone. Whether your dashboard refreshes automatically is your own preference. When it's on, the dashboard refreshes its widgets at the system's dashboard refresh interval, five minutes when that interval isn't set. No single control refreshes every widget at once.

Remove or delete a widget

  • To take a widget off the current dashboard only, click Remove in its title bar in edit mode. The first time you remove a widget after opening a dashboard, you're asked "Remove this widget from the dashboard? You can add it back later." For a placeholder of a widget you aren't allowed to use, the question is "Remove this widget from the dashboard?" The widget itself stays in the widget library; when the palette offers it, you can drag it back. For a widget of an older type that the palette no longer offers and that you're allowed to use, every Remove warns "Remove this legacy widget from the dashboard? You will not be able to add it back again."
  • To delete a widget itself, open its palette entry's Options menu and choose Delete permanently. The Delete widget confirmation reads "Delete this widget permanently? If used on dashboards, it will appear as an empty block. You may want to check its usage first." Click Delete to confirm. Delete permanently isn't offered for analytic charts; it's offered for every other widget the palette lists, including widgets you don't own.

Export and import a widget

A palette entry's Options menu offers Export for the same widget types you can edit. It downloads the widget as a .json file. A Counter Group's file also carries the counter charts it uses; a counter chart that can't be loaded is left out of the file without a message. To bring a file back, open the three-dot menu in the drawer's header, open its submenu for new widgets, and choose the import command; the file picker shows .json files. Importing a widget creates a new, private copy that you own. Importing a chart creates only the chart, as a private chart. Importing a Counter Group also recreates the counters it uses, as private charts. Alloy Navigator refuses a file that isn't a widget transfer file of a supported format version ("Unsupported widget transfer format"), a file in the first version of the format (with a message of its own about missing compatibility information), a file without a product name or version, a file from another product, and a file from a newer product version. It asks you to confirm a file from an older product version.

Create a new dashboard

  1. Open the dashboard picker in the page header and click New. If no dashboard is available to you, New also appears in the page header.
  2. The new dashboard opens empty, in edit mode, on the drawer's Widgets tab. Add widgets as described in Add a widget.
  3. Click Save As, review the name in the Save Dashboard As dialog, and click Save. Until you save it, the new dashboard isn't stored.

If you hold a permission to share dashboards but not Manage Personal Dashboards and Charts, a new dashboard starts shared with everyone.

Save changes

Click Save, in the dashboard picker's panel or in the Customize Dashboard drawer.

A shared dashboard is updated in place only when you own it and hold Share Dashboards and Charts. Otherwise, Save opens a dialog with two choices: save your changes as a private copy, which needs Manage Personal Dashboards and Charts, or update the shared dashboard, which is available only when you're allowed to edit it.

Before saving a sharing change that would take away access, you're asked "You are no longer included in Shared with. You may lose access after saving. Continue?"

Save a copy of a dashboard

  1. Click Save As, in the dashboard picker's panel or in the Customize Dashboard drawer. It's enabled whenever you hold one of the three dashboard permissions, whether or not you've made any changes; in the drawer, the Sharing tab must also be valid (see Share a dashboard).
  2. The Save Dashboard As dialog reads "Create a copy of the dashboard with this name:". Review or change the Name, which is prefilled with the current dashboard's name plus " - Copy", and click Save. Save is disabled while the name is empty.

The copy is a new dashboard that you own, made from what's on screen, unsaved changes included. It becomes the open dashboard, and edit mode ends. The original dashboard is left as it was. The copy takes the sharing set on the drawer's Sharing tab. A copy made from the picker without opening Customize Dashboard is private, unless you customized another dashboard earlier on the page, in which case it takes that dashboard's sharing.

Share a dashboard

  1. Click Customize Dashboard and open the drawer's Sharing tab.
  2. Under Shared with, choose Only me, Everyone, or Specific people or groups. For the last, pick any number of people and groups in the list.
  3. Click Save or Save As.

The dashboard's owner is always included and can't be removed; the owner's entry shows the tooltip "The owner cannot be removed from sharing." Only me is disabled when you may not make the dashboard private, and the other two choices are disabled when you may not edit it as a shared dashboard; a disabled choice shows the tooltip "Permission denied." Choosing Specific people or groups with nobody picked is invalid: Save and Save As stay disabled until you pick at least one. The tab also shows Dashboard name, Owned by, Last modified, and Modified by, with N/A where a value is missing.

A widget has its own, separate sharing, on the Sharing tab of its edit drawer. It offers the same three choices and shows Widget name instead of Dashboard name. It doesn't refuse an empty Specific people or groups selection. When the choice isn't Only me, you aren't the widget's owner, and people or groups are picked on the tab but neither you nor any group you belong to is among them, saving asks "You are no longer included in Shared with. You may lose access after saving. Continue?" and saves only if you confirm. The tab keeps the people and groups you picked when you switch to Everyone, so saving with Everyone can ask the same question.

Role-based access bypass

A chart can be marked to bypass role-based access control, so its data isn't filtered by the viewer's roles and permissions. The Bypass role-based access control check box is on the Sharing tab of the chart's settings, and only technicians who hold the security management permission see it.

A dashboard can carry the same setting. The Web App has no control that shows or changes a dashboard's own bypass setting, and no warning is shown for a dashboard that carries it. On such a dashboard, Analytic Chart widgets, and older Chart and Counters widgets on upgraded dashboards, show their data without role-based filtering, even when the chart itself doesn't bypass it. The dashboard's setting doesn't change what Announcements, View, Create Actions, Links, or Report List widgets show.

On screen, a bypassing chart is marked with an icon:

  • In the title bar of an Analytic Chart widget whose chart bypasses role-based access.
  • Beside the chart's name in the Analytics list.
  • Beside the chart in a Counter Group widget's settings.