Figure: Open Configuration Section
The Traffic Light view displays the status of all instances of activities in a process definition cumulated as a traffic lights/process definition
Note
The Traffic Light view does not
consider Quality Assurance activity instances.
To start the configuration of the Traffic Light View, click the Configuration button in the upper right corner of the Stardust Portal. The Configuration View opens.
Figure: Open Configuration Section
Select Traffic Light to open the Traffic Light specific configuration section.
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 the section Authorization for Process Definitions of chapter Authorization in the Stardust Online Documentation - Modeling Guide Authorization for Process Definitions of the Authorization chapter in the Modeling Guide for detailed information on the Read Process Instance Data permission.
Figure: Select Processes.
The selected processes appear in the Process selection box.
Figure: Select the Process to configure.
Once a process is selected, values for the Traffic Light View properties can be entered or modified.
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.
The table with Row Data Id and Row Data Values, Row Data Id contain the descriptors valid for the selected process. In the Row Data Values entry fields you can enter the descriptor values for which activities should be displayed in the Traffic Light View.
All activities receiving a value in this table are displayed as a column in the Traffic Light View.
Select Save to apply the configuration settings. To discard your settings, choose Cancel.
The Traffic Light view supports a top-level value chain, where the activities represent complex subprocesses.
Figure: The Traffic Light View
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:
:
all instances of this activity are completed
in the planned execution timeframe.
:
if there are any instances of this activity not
completed yet or if there are any process instances that have not yet started
this activity and the planned execution timeframe is not reached yet.
:
if there are any instances of this activity not
completed yet or if there are any process instances that have not yet started
this activity and the planned execution timeframe is exceeded.
:
if no instances exist for a column representing an activity.Hereby, the traffic lights are displayed in a tabular view with one column per activity, e.g.:
Figure: Traffic Lights
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:
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.
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.
To choose the process to be displayed, select it in the Process drop-down list.
Figure: Select Choose Process
To filter the displayed rows by categories, choose one of the provided categories in the Choose Category drop-down list.
Figure: Category Filter
For example the rows grouped by a category called "Product" will be displayed as follows:
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.
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:
You have the option to select the activities to be displayed in
the table and reorder them. Click the Select Columns
icon 
to open
the Select Columns dialog, which is described
in detail in the section Column Selection and Reordering
of chapter Stardust Portal Components.
A list of all activities specified in the Traffic Light configuration is provided.
The data in the table may be exported to a CSV file. To export
to a a CSV file, click the
icon.
Refer to the section Exporting Table Content of chapter Stardust Portal Components for detailed information.
The table may be sorted by any sortable column by clicking the sort icon
in the column header. The table data can be toggled
between ascending and descending order when the sort icon is clicked.
Refer to the section Sorting of chapter Stardust Portal Components for detailed information.
Note
When you try to sort on Category column, the row which shows Total counts would be shown as the last row of table and
the row which shows Undefined counts would be shown as the second last row of table, regardless of sorting.
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 Activity Tables in the Common Tables, Detail Views and Dialogs section.
Please note that for passed activity instances only the actions for notes and invoking process details are enabled.
Figure: Activity instances that have passed the activity.
To see details about the activity instance, click on the Activity Name entry to open the Process Details view.
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 in the Common Tables, Detail Views and Dialogs section.
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.