Viewing the Status of Activities in a Process as Traffic Lights

Note
Two variants of Traffic Light view are available in the Control Center perspective. You can access the old Traffic Light view from the All Management Views panel. The new Traffic Light view is Technology Preview and you can access it from the Monitoring panel.

Traditional Traffic Light View

Open the Traffic Light View from the All Management Views panel of the Control Center Perspective to view the status of all instances of activities in a process definition cumulated as traffic lights/process definition.

Note
The Traffic Light view does not consider Quality Assurance activity instances.

Configuration

To start the configuration of the Traffic Light View, select the Configuration option in the Infinity Portal. The Configuration View opens. For details on this view, refer to chapter Configuring Portal Settings.

Configuration Switch
Figure: Open Configuration Section

Select Traffic Light to open the Traffic Light specific configuration section.

Configuration Rear Panel
Figure: The Traffic Light Configuration Section.

In the Select Process Definitions for configuration pane select one or more processes for configuration. All processes are available for selection, which the logged-in user has the declarative security permission Read Process Instance Data for. This permission is defined for the process definition in the modeler. Refer to section Authorization of chapter Working with Process Definitions in the Business Process Modeling Handbook for detailed information on the Read Process Instance Data permission.

Select Processes.
Figure: Select Processes.

The selected processes appear in the Process selection box.

Select Process.
Figure: Select the Process to configure.

Once a process is selected, values for the Traffic Light View properties can be entered or modified.

Editing Properties.
Figure: Editing Properties.

The State Calculator and Descriptor Filter fields are optional: if no values are entered, the default values are used for the Traffic Light View.

A table with descriptors valid for the selected process is displayed in case descriptors exist. In the Descriptor Values entry field of a descriptor, you can enter the descriptor values for which activities should be displayed in the Traffic Light View. Several values can be entered in a comma-separated list.

In the Processing Threshold table you can enter threshold values per activity to specify the planned termination time of a specific activity instance. The pattern to enter for the termination time is hhmm. In case the indicated time is exceeded before the activity is finished, the traffic light color will turn to red in the Traffic Light view.

Select Save to apply the configuration settings. To reset your settings, choose Reset.

The View

The Traffic Light view supports a top-level value chain, where the activities represent complex subprocesses.

The Traffic Light View
Figure: The Traffic Light View

Traffic Lights

A Java service provider interface is provided to implement specific business logic to decide which color the traffic light should display. The implementing classes need to implement the following interface:

public interface ActivityTrafficLightCalculator 
{
    public int getColorStateForActivity(String processDefintionId, String activityId,  
       int numberOfNotCompletedActivities, 
       int numberOfCompletedActivities);
}

Please add your implementing classes to the classpath of your Web application.

The traffic light icons indicate:

Hereby, the traffic lights are displayed in a tabular view with one column per activity, e.g.:

Traffic Light
Figure: Traffic Lights

Activity count

The numbers displayed along with the colors demonstrate how many activity instances of the activity have been completed out of the total count of activity instances.

Note
Only activities of process instances started on the current day are counted. The activity count is reset to 0 every day as the query fetches process instances with a start date of the current day.

Traffic light history

The state of the instances of an activity is kept at the time the activity reaches its configured escalation time. If the situation is resolved at a later time, this is indicated by a checkmark symbol next to the traffic light:

Traffic Light History
Figure: Traffic Light History

For example if it is expected that all processes of the day finish an activity Cash by 10:00 a.m., but two process instances out of 3 are late and the traffic light changes to red at 10:00 a.m. Some time later the two missing process instances pass through the activity. The traffic light does not change to green then, but the checkmark next to the traffic light shows that it was resolved later.

Rows

A number of rows where data filter are applied against the process instances on the values is displayed. You can determine which categories are displayed in the rows in the category filter.

Process Filter

To choose the process to be displayed, select it in the Process drop-down list.

Select Choose Process
Figure: Select Choose Process

Category Filter

To filter the displayed rows by categories, choose one of the provided categories in the Choose Category drop-down list.

Category Filter
Figure: Category Filter

For example the rows grouped by a category called "Product" will be displayed as follows:

Dynamic Row Grouping
Figure: Dynamic Row Grouping Example

The number of completed activity instances and the total number of activity instances in the corresponding category is displayed beside the traffic light. For example 1/2 is displayed for 1 completed activity instance of 2 in total.

Display Activity Instances List

To display all activity instances possibly filtered by the corresponding data filter, click the corresponding traffic light.


Figure: Select to display the Activity Instances

Two tables will open displaying all descriptor values of the underlying instance and the appropriate start time:

Activity Completed

This table includes all activity instances which have passed the selected activity. For a detailed description on the columns and functionality of the activity table, refer to chapter Working with Activity Tables.

Please note that for passed activity instances only the actions for notes and invoking process details are enabled.

Activity instances passed activity
Figure: Activity instances that have passed the activity.

To see details about the activity instance, click on the Activity Name entry to open the Viewing Process Details view.

Activity Completion Pending

This table includes all activity instances which have not passed the selected activity. For a detailed description on the columns and functionality of the activity table, refer to chapter Activity Tables.

Activity instances not passed activity
Figure: Activity instances that have not passed the activity.

To see details about the activity instance, click on the Activity Name entry to open the Process Details view.

Technology Preview - Traffic Light View

Displays graphical traffic of Processes and Activities based on a benchmark, if specified. It also displays traffic of completed and aborted processes and activities.

Open the Traffic Light View from the Monitoring panel of the Control Center Perspective to view the status of all instances of activities in a process definition cumulated as a traffic light and process definition.

Traffic Light View - Monitoring
Figure: Traffic Light View - Monitoring

You can specify the filter for traffic light using following parameters:

Traffic Lights for Business Object Instances

Drill down by business object.

  1. Processes - By default, All Processes option is selected. You can select multiple processes using Ctrl+Click.
  2. Benchmarks - By default, All Benchmarks option is selected. You can select multiple benchmarks using Ctrl+Click. However, when multiple benchmarks are selected, they must have the same categories defined. That is, they must have the identical number of categories and these must have the same labels and colors. An error message is displayed if the selected benchmark definitions do not have identical categories.


    Figure: Error Message - No Identical Categories

  3. Drill Down - You can drill-down based on a business object.


    Figure: Business Object - Drill Down

  4. Date - You can select Business Date or Process Start Time Date from the drop-down list
  5. Offset - By default, 0 value is displayed. You can specify only negative integer value. 0 indicates Today, -1 indicates data from yesterday till now, -2 indicates data from last two days and so on.
  6. Show - Select processes or activities from the drop-down list

The Date filter provides a date range starting from the current date +/- the offset. For example, if Date = Business Date and offset = -1 the filter would include PIs/AIs where Business Date = today and yesterday.

The following screenshot displays traffic light based on the drill down.


Figure: Traffic Light View - Business Object Instance Process

Click on the count displayed for the process or activity to view the details.


Figure: Business Object - Drill Down

Traffic Lights for Specific Processes or Activities

The Traffic Light view supports the inclusion of process instances.

Drill down by process or worklist item.

  1. Processes - By default, All Processes option is selected. You can select multiple processes using Ctrl+Click.
  2. Benchmarks - By default, All Benchmarks option is selected. You can select multiple benchmarks using Ctrl+Click. However, when multiple benchmarks are selected, they must have the same categories defined. That is, they must have the identical number of categories and these must have the same labels and colors. An error message is displayed if the selected benchmark definitions do not have identical categories.


    Figure: Error Message - No Identical Categories

  3. Drill Down - Drill down based on process or work item


    Figure: Process/Work Item - Drill Down

  4. Date - You can select Business Date or Process Start Time Date from the drop-down list.
  5. Offset - By default, 0 value is displayed. You can specify only negative integer value. 0 indicates Today, -1 indicates data from yesterday till now, -2 indicates data from last two days and so on.

The Date filter provides a date range starting from the current date +/- the offset. For example, if Date = Business Date and offset = -1 the filter would include PIs/AIs where Business Date = today and yesterday.

The following screenshot displays traffic light based on the drill down.


Figure: Traffic Light View - Process

Click on the count displayed for the process or activity to view the details.


Figure: Process / Activity Details