WiscIT Widget - Gauges

These widgets display the numerical results from the chosen search criteria.

New Gauge Widget Window

The new Gauge widget window is separated into two sections, Gauge and Options.
Gauge area
Gauge: This area does not change based on the selections made beyond the example widget on the right-hand side.
  • Gauge Type: There are three general types of gauges: linear, speedometer, and text-type. Each type has three or four versions, and the selection of one of these types will change some of the options in the lower Options section.
  • Default Title: This is where the title of the widget would be entered. It does not have to be filled in, nor does it have to match the "Name" field at the top of the widget window.
  • Business Object: Select the Business Object the widget should be associated with. Check the "Show All" box to see all the possible Business Objects.
  • Refresh Every [#] [Time Period]: Set the widget to refresh at certain intervals to keep the information up to date if the dashboard is not refreshed in that time period.
  • Exclude From Filters: This sets the widget to not be affected if a filter is used in a dashboard.
Options: Parts of this area change depending on the Gauge Type selected in the Gauge area.
Criteria area
  • Criteria: This area is where the actual data to use in the gauge is selected.
    • Search Criteria: A pre-made or custom search can be used to draw data for the gauge. The ellipsis button opens the Search Manager and the magnifying glass opens the Custom Query window. See WiscIT - Using the Search Function in Cherwell if needed.
    • Date Range: This chooses the date range for the widget to work within.
      • Range: This sets a date range for the widget to use in any instance of the widget, unless a Filter widget is also being used in the dashboard that would change the date range used.
      • User Selectable: Opens a dialog box that gives a range of options a user would be able to select from when using the widget on their own dashboard.
      • Field used for Date Range: This gives a field for the widget to focus on when using the date range. For example, if Last Modified Date Time is the field selected and the date range is "Within the last 1 month", the series will show all the tickets that fit the search criteria that have been modified in the last month.
  • Values: This chooses how the search results are displayed in the gauge widget.
Value area
    • Value: This is where the primary value is selected.
      • Number of Records: This displays a count of the results.
      • Function/Field: Uses a different function (average, minimum, maximum, or total), selected from the dropdown and what field of the Business Object is used for that function.
      • Duration Function: Uses a different function (average, minimum, maximum, or total), selected from the dropdown. It also has areas to select the start time and end time of the desired duration, along with a drop-down box to select the units the gauge should use.
      • Metric: Select this option to use a Metric value. Select an existing metric from the dropdown. Adjust the selected Metric by clicking on the icon to the right of the dropdown box.
Secondary area
    • Secondary Value: Check the checkbox to use the secondary value to calculate the final result.
Properties area
  • Properties: This sets the minimum and maximum values to be used in the gauge.
    • Auto-Raise Value: Check this box to have the maximum value go up as the actual number rises.
    • Logarithmic Scale: Check this box to use a logarithmic scale in the widget. It is only available with linear gauges.
Number Properties area
  • Number Properties: This area is for selecting the settings for a text-type gauge.
    • Category: This section allows selection of a "number type" to be shown. Only the "Text" type widget can use a category other than Number (Currency, Percentage, and Custom). The various choices to the right change depending on the category chosen.
Thresholds area
  • Thresholds: If certain thresholds need to be monitored, these can be activated by checking the "Use thresholds" checkbox. This option appears when a linear or speedometer widget type is being made.
    • Start Range: This gives a starting area for the threshold range, usually to show a good level range. The color can be changed at the creator's discretion. If the start range is not selected, a middle range must be selected in order for the threshold to be used.
    • Middle Range: This gives a middle range for the threshold range, usually to show a medium or warning level. If a start range is selected, this does not necessarily need to be used, but it can give a more granular status level.
    • End Range: This gives an end for the threshold. This must be used with any threshold. Like the other range, the color can also be changed.
    • Using Solid Colors: This sections the thresholds into separate ranges, giving hard limits before the next range is delineated.
Drill-down area
  • Drill-Down: This allows the creator of the widget to choose what happens when a user clicks on the widget.
    • Go to Record List: This is the most common choice, to have clicking on the gauge go to the results that fit the criteria the search used in the criteria.
    • Execute a Command: Have clicking on the gauge activate a command, which can be chosen from the ellipsis button on the right if this is selected.
    • Go to a Dashboard: Have clicking on a the widget bring the user to a dashboard, which can be chosen from the ellipsis button on the right if this is selected. If the filter box is checked, then filter choices on the dashboard with the widget currently in production will also be used on the dashboard that is being drilled-down to. For example, if the dashboard filter is set to "Within the last 1 week" and a user drills down to the dashboard through this widget, the dashboard will also have the filter "Within the last 1 week".
    • Don't Allow Drill-Down: Turns off drill-down options and makes the gauge read-only.
Display area
  • Display: This menu has the display options for the gauge.
    • Allow Animation: This toggles animation of the chart on and off. Animation generally only happens when a dashboard using the widget is opened.
    • Advanced Options
      • Override Dashboard Theme Colors: If the colors of the widget need to stay how they are regardless of the color theme chosen for a dashboard, check this box. Legacy Themes are from previous versions of Cherwell, Specific Themes are the other color themes that are available. A different pre-made theme can be found from the Theme Manager by clicking on the button with an ellipsis to the right of the dropdown box (new themes can also be created from here).
      • Override Dashboard Style: Check this box to override the dashboard theme style, then select a specific style to be used whenever this widget is in use.



Keywords:Cherwell, number, speedometer, linear, text, currency   Doc ID:46669
Owner:Chris G.Group:WiscIT - Wisconsin IT Service Manager
Created:2015-02-02 12:56 CDTUpdated:2015-05-22 13:49 CDT
Sites:DoIT Help Desk, WiscIT - Wisconsin IT Service Manager
Feedback:  0   0