Administration Guide

Shared Dashboards and Widgets

On this page

A dashboard is a layout, and a widget is a content block placed on it. Besides the shared dashboards, a person can have a private override of a shared dashboard, which applies to that person only. A widget is one object that can be placed on several dashboards. An analytic chart placed on a dashboard is referenced, not copied, so editing the chart changes every dashboard that shows it.

Creating widgets, placing them on dashboards, and sharing dashboard views and widgets happen in the Web App; see Dashboards. This includes Analytic Chart and Counter Group widgets, which the Settings App does not list. The Settings App cannot create or copy widgets, but its configuration import still accepts widgets, and its Widget Manager edits and deletes existing widgets, as described below.

Who sees which

Dashboards

Dashboard visibility does not depend on security roles, and the built-in administrator account gets no special access: every shared dashboard is visible to every technician. A dashboard has no audience setting of its own. What you share in the Web App is the dashboard view, with one of three audiences: Only me, Everyone, or Specific people or groups.

A new 2026.1 database created with the Default Workflow has these shared dashboard views: Change Management, My Dashboard, IT Asset Management, IT Service Management KPIs, Service Request Management, Project Management, Incident and Problem Management, Library and Reservation Management, and Software Asset Management. IT Service Management KPIs and Service Request Management carry customer satisfaction rating charts and Report List widgets that list the Customer Satisfaction Rating reports: the one on IT Service Management KPIs lists Customer Satisfaction Rating (Incidents) and Customer Satisfaction Rating (Service Requests), and the one on Service Request Management lists Customer Satisfaction Rating (Service Requests). The ratings these charts plot are filled in only for a technician who holds View All Ratings, or View Own Ratings for tickets assigned to that technician. An upgraded database need not have these dashboard views, and an administrator may have changed them.

Widgets

You can use a widget when you own it, when it is shared with everyone, or when it is shared with you. In the Web App, a widget's audience is Only me, Everyone, or Specific people or groups. Widget sharing does not follow security roles.

When a database from an earlier version is upgraded, widgets that were shared with security roles are converted once into shares with each person who held those roles at that moment. These shares do not follow later changes to role membership: a person added to a role afterward does not see such a widget until the widget's sharing is changed to include that person. Views, board views, dashboard views, and analytic charts that were shared with a group keep that group share and continue to follow group membership. The upgrade also gives every existing widget an owner: one active person who holds a particular permission, chosen arbitrarily. The same upgrade grants four further permissions to every security role that holds that permission.

A new 2026.1 database created with the Default Workflow receives no Chart, Table, Counters, or Latest Activities widgets from that configuration. The analytic charts the configuration supplies are a new selection, not one-for-one replacements of the widgets of those four types that version 25.3.1 supplied. An upgraded database need not have this content, and an administrator may have changed it.

What each viewer sees in a widget

In the Web App, the widget library offers a technician only the widgets that person may use, and it never lists legacy Chart, Table, Counters, and Latest Activities widgets. When a technician builds a Counter Group widget, its picker offers only the counter charts that person can already see. What a placed widget shows also depends on the viewer:

  • A widget on a dashboard that the viewer may not use appears as a placeholder with a message, not as its content.
  • A Create Actions widget lists only the creation actions that the viewer's security roles allow.
  • A Report List widget leaves out, with no placeholder, an item whose report the viewer cannot see.
  • A View widget lists every item for every viewer. Only the count next to an item depends on the viewer: it reads "N/A" when the viewer cannot see the view, and also when the count cannot be retrieved.

In the Settings App

The Settings App's Widget Manager lists existing widgets, and you can edit or delete them there. It shows a deprecation banner with a link to the upgrade considerations in the release notes.

Before you begin

  • The Widget Manager appears only while the database holds at least one legacy Chart, Table, Counters, or Latest Activities widget.

Open the Widget Manager

In the Settings App, under General, open Dashboard Management > Widgets.

The Widget Manager groups widgets in nine sections: Announcements, Charts, Counters, Create Actions, Latest Activities, Links, Report Lists, Tables, and Views. Analytic Chart and Counter Group widgets are not listed.

The toolbar's add and Copy Item actions can appear available, but they do nothing: widgets cannot be created or duplicated here. Edit works on one selected widget at a time.

Delete a widget

  1. In the Widget Manager, select one or more widgets and choose Delete.
  2. Confirm the question "Are you sure you want to delete the selected item?"

A widget that is placed in a dashboard panel is not deleted, and the Settings App shows "You cannot delete the widget "<name>" because it is displayed on one or more dashboards. Remove the widget from the dashboards first." When several widgets are selected, the first refusal offers Yes, Yes to All, and No before the remaining widgets are deleted. A widget that is deleted is also removed from every dashboard layout that still references it.

Edit a widget

  1. In the Widget Manager, open the section for the widget's type.
  2. Select the widget and choose Edit. The widget's property window opens, captioned for its type, for example Table Widget Properties.
  3. In the General box, change Name (up to 276 characters) and Title as needed.
  4. Change the settings of the widget's type, described below.
  5. Save the widget. The name, the title, and the type's settings are saved together.

Announcements

The Display properties box holds Number of announcements to display, with a minimum of 1. The widget in the Web App shows at most that many announcements.

These widgets hold a list of items, in a box named Links, Views, Actions, or Reports. The list's toolbar has New, Edit, Delete, Move Up, and Move Down; Edit and Delete need a selected row, and a double-click on a row edits it. New opens the item dialog as New Item, and Edit opens it as Item Properties; every item has a Caption.

  • Links: Link Type is one of Custom Link, Alloy Support Portal, Product Home, Settings, Import, or Alloy Discovery. Only Custom Link lets you type an address in Link, and OK stays unavailable until you do. Choosing another type clears the address and puts the type's name into Caption. A caption equal to the address is cleared on save, so the item shows the address itself.
  • Create Actions and Views: for a new item, the picker opens right away. The Create Actions picker offers the creation and registration actions of licensed classes. Picking fills Create Action Name or View Name (a view is shown as Object Name (View Name)) and replaces Caption, which you can then edit. OK stays unavailable until an action is picked, or until both a class and a view are picked. Use Select to pick again. In a Views widget, an item whose view can no longer be found is captioned with the list name and the view name, and is shown as not found until you pick a view for it again. The Create Actions editor can also mark an item as not found, and picking an action again clears the mark.
  • Report Lists: each item is a report you pick by name, with a caption that defaults to the report's current name. A Report List item's caption is fixed the first time the item is saved, even without edits, and does not follow a later rename of the report. Items of the other list widgets keep following their target's current name as long as you leave the caption unchanged. If an item's report has been deleted, the editor shows <deleted> in place of its name.

Tables

  • Table data: Class is required, and Fields shows the widget's current column list, read-only. The class list holds the licensed classes except Object Activity, Task Parent, and Vendor Product, plus Discovered Installations, My Tasks, and My Tickets.
  • Customize opens the Customize Table window, with the tabs Fields, Advanced Filter, and Conditional Formatting. On Fields, you move fields between Available Fields and Show These Fields and set the Sorting order. Advanced Filter switches between Switch to SQL Mode and Switch to Design Mode. Conditional Formatting lists rules; a rule opens Conditional Formatting Rule with Name, Enabled, Apply to (Row, First column, or Column), Condition, and Apply Style.
  • Preview shows the widget. Customize and Preview are available once a class is chosen.
  • Display properties: the check box Limit the number of records to, with a number that starts at 10.

Latest Activities

  • The Data grid lists selection rules with the columns Object Class, Condition, Description, and Enabled, and a toolbar of New, Edit, and Delete. Edit and Delete need a focused rule, and a double-click edits the focused rule. Condition shows the rule's object filter, a comma, and then either All Activities or Activity: followed by the activity filter.
  • A rule opens in the Selection Rule window: Object Class (a list of the licensed, visible classes that have activities; required; confirming the window without one keeps it open and shows a required-field error), Object Filter (available once a class is chosen), Activity Filter, Show only if it is the latest object's activity, Description (the text shown for the rule in the Data grid), and Enabled. The ellipsis button of Object Filter and of Activity Filter opens the Filter window, where you build the condition; see Build a condition in the Filter window.
  • Customize opens the Customize Table window for the activity grid, with the Fields and Conditional Formatting tabs. Preview opens Latest Activity Preview with the live widget.
  • Display properties:
    • Preview Activity Details and limit the number of lines to: 1 to 10, 3 by default, available only while the check box is selected.
    • Retrieve records for the last n days: 1 to 366, 30 by default.
    • Limit the number of records to display to: 1 to 100, 10 by default.

Counters

  • The Tiles box has New, Edit, Delete, Move Up, Move Down, and Copy Tile. Edit, Delete, and Copy Tile need a selected tile, Move Up and Move Down need a tile above or below it, and a double-click edits a tile. Copy Tile opens a copy named "<name> (Copy)" in the tile dialog; canceling it adds nothing. Preview opens Counter Preview with the whole widget.
  • A tile opens in Tile Properties (New Tile for a new tile), on three tabs:
    • General: Name, Align, and Color.
    • Data: Label, Metric, and Previous metric for trend calculation (optional), each either Text or SQL Script. A bad script is refused with "Bad SQL property for the <element> element:" followed by the database message. A tile's SQL accepts macros such as <CURRENT USER>, <CURRENT USER ORGANIZATION>, and <CURRENT USER LOCATION>.
    • Display Properties: Layout (the order of label, metric, and trend), Trend calculation (Previous Metric, % of Previous Metric, Increase, or % Increase), Trend Symbol, Symbol Position (fixed to the left and unavailable while no symbol is chosen), Decimal Digits for metric and trend (maximum 9, 2 by default), Set Font..., and an Align setting for each of label, metric, and trend.
  • Refresh Preview redraws the tile in the dialog. Save Style as Default asks "Do you want to save this style as the default style for all new tiles?" and then saves the tile's style as the default for all new tiles in the database, not per user.

Charts

  • Source is either Interactive chart with drill-down support or Static chart based on custom SQL.
  • For a drill-down chart: Class (the same class list as for tables), Fields (opens the Customize Table window with only the field lists), Group by, Then by, Function, and Order by with Ascending or Descending. Class, Fields, Group by, and Function are required. Function always offers Count(*), plus SUM, MIN, MAX, and AVG for numeric fields.
  • For a custom SQL chart, enter the query in the box prompted "Enter the SQL query that selects the data to display in the chart." The query is checked when you save the widget. It needs at least two fields; the first a string, date, numeric, Boolean, or ID field, and the last a numeric or date field. The error for a query that doesn't fit shows two accepted forms: select [Field1], count(*) from Table1 group by [Field1] and select [Field1], [Field2], count(*) from Table1 group by [Field1], [Field2].
  • Display properties: Chart Type (Bar, Line, or Pie), Palette (Solid Color swaps in a color picker), Show legend with on the Left, Right, Top, or Bottom, Show marks with as, and Show X axis labels, which a pie chart disables. Saving a pie chart with a Then by grouping is refused with "Pie charts do not support nested grouping. To continue, clear the "Then by" option or choose a different chart type."
  • Advanced properties: Limit the length of the legend text to (15 characters by default) and Limit the number of elements to display to (5 by default, for either source), beside Preview and Adjust Colors. Adjust Colors is offered only for a drill-down chart whose grouping is not a date and whose palette is not Solid Color.
  • Filters opens Manage Chart Filters, a list with Name and Condition and a toolbar of Add, Edit, Delete, Move Up, Move Down, and Copy; a double-click edits a filter, and Delete asks for confirmation first. Each filter opens in Filter Editor, where Name is required and the condition switches between Switch to SQL Mode and Switch to Design Mode; a custom SQL chart's filter is SQL only. When a chart has exactly one filter, its condition is added to the chart's own query; several filters are a choice offered where the chart is shown, not conditions added to the query. The preview applies the first filter in the list, and when the chart has more than one filter, it shows a filter bar to choose another. Choosing a filter on that bar reruns the chart's query and reloads the preview's chart and Chart data grid; if the query fails, an error window shows the statement.
  • Adjust Colors runs the chart's query and, only if the query succeeds, opens Assign Colors, a grid of values and colors. Add adds a row with the first unused palette color, Remove asks "Delete record?", and Set Default returns a value to the palette color. OK refuses a blank value. Leaving the window with unsaved edits offers to save them first.
  • Preview runs the chart's query and, only if the query succeeds, opens Chart Preview, whose only button is Close, with a Chart data grid below the chart. The grid has a color cell for each row only for some charts, and never while the palette is Solid Color; in that cell, Default color returns the value to the palette color. Colors you set in the preview are kept in the widget however you close the window. A chart with no data reads <No data to display>.