Widgets

Overview

Widgets are graphic and/or alphanumeric displays of of real-time, dynamic information about Universal Controller, the jobs it is running, and the environment in which it is operating.

Some Widgets are provided by the Controller, and you can create as many other Widgets as desired. You can add any Widget to any dashboard except the Home Dashboard.

Types of Widgets

There are three type of Widgets:

Creating a Widget


Note

You can create Widgets (Activity Widgets and Report Widgets only; System Widgets cannot be created) only if you have been assigned the ops_admin, ops_report_admin, or ops_widget_admin role; otherwise, the New button does not display at the top of the Widgets list.

Step 1

From the Reporting navigation pane, select Widgets. The Widgets list displays.
 

Step 2

From the New drop-down list at the top of the list, select the type of Widget you want to create:

  • Activity Widget
  • Report Widget

The Widget Details for that Widget type displays.

Note

The General section of Widget Details is the same for System, Activity, and Report Widgets, but the Details section is different for all three types of Widgets.

Step 3

Enter / select Details for a new Widget, using the field descriptions as a guide.

  • Required fields display an asterisk ( * ) after the field name.
  • Default values for fields, if available, display automatically.

To display more of the Details fields on the screen, you can either:

  • Use the scroll bar.
  • Temporarily hide the list above the Details.
  • Click the New button above the list to display a pop-up version of the Details.

Step 4

Click a Save button. The Widget record is added to the database, and all buttons in the Widget Details are enabled.

Step 5

To see how the Widget will display, click the Preview button.
 
Graphic Widgets identify the entries that comprise the graphic with color, and an alphanumeric key identifies the number of each entry type represented by the color. You also can see what percent of Widget entries are in each type by hovering your cursor over that portion of the graphic.

System Widgets

System Widgets contain information about:

  • Controller system details
  • Agent, Cluster Node, and OMS Server status
  • Task instance status and type

All System Widgets are provided by the Controller. You cannot modify or delete a System Widget, but you can add or remove it from any Dashboard.

System Widget Details

The following System Widget Details is for the System Details Widget. See the field descriptions below for a description of all fields that display in the System Widget Details for the System Details Widget.
 

System Widget Details Field Descriptions

The following table describes the fields, buttons, and tabs that display in the System Details Widget Details, above.
 

Field Name

Description

General

This section contains general information about the Widget.

Name

Name of the Widget

Widget Type

Type of this Widget: System.

Description

Description of this record. Maximum length is 255 characters.

Refresh Rate (Seconds)

Time interval (in seconds) when the dynamic data in this Widget is refreshed.

Details

This section contains detailed information about the Widget.

System Widget Type

Type of this System Widget.

Metadata

This section contains Metadata information about this record.

UUID

Universally Unique Identifier of this record.

Updated By

Name of the user that last updated this record.

Updated

Date and time that this record was last updated.

Created By

Name of the user that created this record.

Created

Date and time that this record was created.

Buttons

This section identifies the buttons displayed above and below the Widget Details that let you perform various actions.

Preview

Provides a preview of how this Widget will display on a Dashboard.

Close

For pop-up view only; closes the pop-up view of this Widget.

System Details Widget Preview

The following preview shows how the System Details Widget above will display on a Dashboard.
 

Note

By default, the only System Details categories that display expanded categories are those specified in the System Details Expanded Categories Universal Controller system property.

Activity Widgets

Activity Widgets contain information about Controller activity; that is, task instance statuses.

The Controller provides a set of Activity Widgets, which you can modify and delete, and you can create your own Activity Widgets.

You also can create an Activity Widget that is a composite of other Activity Widgets

All Activity Widgets display as horizontal bar charts.

Composite Widgets

Composite Widgets are Activity Widgets composed of other Activity Widgets. Composite Widgets can contain any Activity Widgets except other composite Widgets.

To create a Composite Widget, you select task instance statuses for the Widget in the Composite Status(es) field in the Activity Widget Details.

Activity Widget Details

The following Activity Widget Details is for a Success/Finished Activity Widget: a widget based on Success and Finished task instance statuses. See the field descriptions below for a description of all fields that display in the Activity Widget Details.
 

Activity Widget Details Field Descriptions

The following table describes the fields, buttons, and tabs that display in the Success/Finished Activity Widget Details, above.
 

Field Name

Description

General

This section contains general information about the Widget.

Name

Name of the Widget.
 

Note

The name of an Activity Widget should reference - either directly or indirectly - the task instance Status(es) for which it is created. For Example, if you create a Widget for a specific status and simply name it Widget A, and Widget A then is included in a Composite Widget, that Composite Widget will display on a Dashboard with an entry for Widget A, which provides no indication of the status for which it was created.

Widget Type

Type of this Widget: Activity.

Description

Description of this record. Maximum length is 255 characters.

Refresh Rate (Seconds)

Time interval (in seconds) when the dynamic data in this Widget is refreshed.

Details

This section contains detailed information about the Widget.

Status(es)

Task instance status(es) to include in this Widget.

Time Constraint

Time frame for which you want task instances in the selected status(es) to be included in this Widget.
 
The Time Constraint defined for a Composite Widget overrides the Time Constraints defined in each of its individual Activity Widgets.

Composite Status(es)

Activity Widget(s) to include in this Widget. Each Activity Widget represents one or more task instance statuses. Selecting one or more Activity Widgets in this field, rather than selecting status(es) in the Status(es) field, makes this Widget a composite Activity Widget.

Composite Color

Color used on a Dashboard for this Widget if it is part of a composite Activity Widget.

Metadata

This section contains Metadata information about this record.

UUID

Universally Unique Identifier of this record.

Updated By

Name of the user that last updated this record.

Updated

Date and time that this record was last updated.

Created By

Name of the user that created this record.

Created

Date and time that this record was created.

Buttons

This section identifies the buttons displayed above and below the Widget Details that let you perform various actions.

Save

Saves a new Widget record in the Controller database.

Save & New

Saves a new record in the Controller database and redisplays empty Details so that you can create another new record.

Save & View

Saves a new record in the Controller database and continues to display that record.

Update

Saves updates to the record.

Preview

Provides a preview of how this Widget will display on a Dashboard.

Delete

Deletes the current record.

Close

For pop-up view only; closes the pop-up view of this Widget.

Activity Widget Preview

The following preview shows how the Success/Finished Activity Widget above - provided by Universal Controller - will display on a Dashboard.
 

Report Widgets

Report Widgets are based on any Report.

A Report Widget displays in the format selected for the report:

  • List
  • Bar Chart/Horizontal
  • Bar Chart/Vertical
  • Pie Chart

Report Widget Details

The following Report Widget Details is for an All Widgets Report Widget: it is based on a report using the Widgets (ops_widget) Universal Controller Reportable table. See the field descriptions below for a description of all fields that display in the Report Widget Details.
 

Report Widget Details Field Descriptions

The following table describes the fields, buttons, and tabs that display in the All Widgets Report Widget Details.
 

Field Name

Description

General

This section contains general information about the Widget.

Name

Name of the Widget

Widget Type

Type of this Widget: Report.

Description

Description of this record. Maximum length is 255 characters.

Refresh Rate (Seconds)

Time interval (in seconds) when the dynamic data in this Widget is refreshed.

Details

This section contains detailed information about the Widget.

Report

Report on which this Widget is based.

Metadata

This section contains Metadata information about this record.

UUID

Universally Unique Identifier of this record.

Updated By

Name of the user that last updated this record.

Updated

Date and time that this record was last updated.

Created By

Name of the user that created this record.

Created

Date and time that this record was created.

Buttons

This section identifies the buttons displayed above and below the Widget Details that let you perform various actions.

Save

Saves a new Widget record in the Controller database.

Save & New

Saves a new record in the Controller database and redisplays empty Details so that you can create another new record.

Save & View

Saves a new record in the Controller database and continues to display that record.

Update

Saves updates to the record.

Preview

Provides a preview of how this Widget will display on a Dashboard.

Delete

Deletes the current record.

Close

For pop-up view only; closes the pop-up view of this Widget.

Report Widget Preview

The following preview shows how the All Widgets Report Widget above will display on a Dashboard.
 

Additional Details

For information on how to access additional details - such as Metadata and complete database Details - for a Widget (or any type of record), see Records.