Figure: Select a Perspective to work with.
The Stardust Portal provides perspectives as combinations of menu items, launch pads and default views. Perspectives can be selected in the Perspectives menu item in the main menu.
Figure: Select a Perspective to work with.
The following Stardust Portal perspectives are provided:
Please note that the Administration Perspective is only available for users having administration rights.
Some access to views and information on data, activity instances or process instances in views is restricted to users having a specific authorization set. This also concerns available actions in the views like delegation, termination etc. The authorizations can be set in the Stardust modeler or via API. For details on how to set these authorizations and on their effects, refer to the chapters Authorization in the Stardust Online Documentation - Developer Modeling Guide Authorization of the Modeling Guide and Declarative Security Usage in Stardust Services API in the Stardust Online Documentation - Developer Programming Guide Declarative Security Usage in Stardust Services API in the Programming Guide accordingly.
A set of default launch panels is provided in the perspectives allowing to populate a worklist with content for different selection criteria.
Figure: Example launch panel in the Workflow Execution Perspective.
You have the option to hide or show the according launch panels by clicking the Hide Launch Panels and Show Launch Panels button accordingly:
The following Stardust Portal Components are provided in all Stardust Portal perspectives:
To select the columns to be displayed in the table and reorder
them, a dialog is provided. To open this dialog, select the icon (
) in the table
toolbar.
Clearing the check box next to a column name removes the column from the table. Clicking a column and dragging it to another location reorders the columns.
Figure: Select Columns Dialog
Administrators are allowed to configure the default process/participant worklist columns. A drop down list is available to select whether the changes apply globally (Everyone) or to only the administrator's user account (Me).
Figure: Scope Drop Down
The default option is to apply the changes to the logged-in user (Me).
Note that in the Portal Configuration view, the administrator also has the option to set a default layout for participant worklists. He has the option to specify whether a participant may override a default layout, as well a per role-based worklist as for personal worklists. When the administrator has locked a column layout, it is not editable. Refer to section Participant Worklist Configuration of chapter Portal Configuration for details on these configuration settings.
A Lock button is provided for administrators to set a lock on participant and process worklist column selectors. The lock icon displays the current lock state, and administrators can use it to lock or unlock the default participant or process worklist.
Figure: Lock Icon
The Apply to Me is disabled for the logged-in user (both, administrators as well as non-administrators), if the column settings have been locked by an administrator.
Figure:
A reset icon 
is available for all
users to reset the defined preferences to the default setting.
Figure: The Column Selector Dialog.
A confirmation dialog opens to confirm the reset operation:
Figure: Reset Confirmation
If the logged-in user has administrator rights, the reset behavior depends on the scope configuration as follows:
To filter the data displayed in a column, a dialog is provided.
Select the ( 
) icon
in the table toolbar to open this dialog.
Figure: Filter Dialog for Date Entries
Filters are displayed in the column header cell. In case no filter is set, the column header displays "No filter set."
Figure: No Filter Set
In case a filter is set, this is indicated in the column header with the filter range displayed.
Figure: Filter Set indicated in Column Header.
The following different filtering types are available depending on the column data type:
Section Resetting Filters describes how to reset filters.
String entries can be filtered via the Like mechanism. You can use the asterisk '*' wildcard. Note that the search is case-insensitive.
Figure: String Filter
By default, search is performed for the specified character. If first name and last name are provided then search is performed on both the strings. If only one of the two search strings are specified then search is performed only for that matching string and other field is ignored.
Figure: Name Filter
The numeric filter allows filtering between. You can enter a From and a To value. Unspecified upper or lower limit allows defining greater than or less than.
Figure: Numeric Filter
Filtering for dates allows between filtering. You can either enter a From and a To value in the current supported date format (e.g. dd/mm/yy:hh:mm PM), or by using the date picker in the provided calendar.
Figure: Date Filter
Similarly, you can filter end time.
Figure: Filtering End Time
To filter activities, you can select the activities from multiple processes. The activities are sorted in alphabetical order.
In the Process box, you have the following options:
In the Activity box you can select a single activity or multiple activities for the filter.
Figure: Filtering Activities
The activity criticality filter can be set using the Like mechanism. You can provide the criticality label in the Select Criticality text box. By default, criticality labels are defined as High , Medium and Low.
Figure: Filtering Criticality
In case you want to remove the provided criticality filter, click X icon in the Remove column of the Selected Criticality pane.
Figure: Remove Criticality Filter
To filter processes, you can select the processes from a provided list. The processes are sorted in alphabetical order.
Figure: Filtering Processes
To filter status, select one or more status from a list.
Figure: Filtering Status
You can simply remove a filter by clicking
the Reset Filter icon
, which overlays the filter icon:
Figure: Reset the Filter
The status of the filter will return to No filter set afterwards.
The table may be sorted by any sortable column by clicking the sort icon 
in a column. By default, it is sorted in descending order that is the newest item is always displayed on top.
The sort icon is divided in two triangles. When
you click on the sort icon the triangle is highlighted to indicate the sort.
The table data can be toggled between ascending and
descending order when the sort icon is clicked.
Figure: Sort Icon
A table row can be selected by clicking on the row. The selected row is highlighted and already selected rows are deselected. To select more than one row, use one of the following mouse clicks depending on which rows you like to select:
Figure: Highlighted Selected Rows
The toolbar contains buttons to export the table content to Excel
( 
) or as a CSV ( 
) file.
The following paging controls are provided to navigate through table data, in case the number of entries exceeds the maximum number of rows per table page. The default number is 8, but can be adjusted in the Portal Configuration panel.
Figure: Paging
You can use the buttons for next, previous, fast forward, fast back, view first and view last operations or select specific pages of data to be displayed.
In case the paging controls are visible, additionally a paging infobar is displayed above the table giving information on total rows, displayed page numbers and record numbers.
Figure: Paging Infobar
In some cases, e.g. after terminating more processes than rows displayed in a table, it might happen that pages that are not valid anymore are still displayed, but without entries, or that the paging infobar is not updated.
In that case, refresh the view or click on any other page to update the table entries and paging details.
You have the option to configure some settings for the Stardust Portal and its views in a configuration panel, which is described in detail in the chapter Portal Configuration.
To open the configuration panel, click the Configuration link in the upper right corner of the portal.
Figure: Open the Configuration Panel.
Two switches to pin the portal view vertically or horizontally are provided as menu items.
Figure: Pinning view option.
Clicking one of the pin options takes the currently focused view and puts it in one part of a horizontal or vertical split pane whereas all other views reside in a tab structure in the other part of that split pane. The pinned view can serve as a target for drag and drop operations which could be easily done from all views in the remaining tabs.
Figure: Example for horizontally split views.
The Pin View option is also available for Manual Activity panel. You can pin the activity view vertically or horizontally.
If the split mode is selected, a Restore Pin View option is provided in the main menu to merge all views back into one tab view.
Figure: Restore the pin view.
To close the currently focused view explicitly, click the Close Focus View icon in the main menu.
Figure: Close the Focus View.
To close all open views, click the Close All Open Views icon in the main menu.
Figure: Close All Open Views.
You have the option to adjust the format of date and time fields represented in tables of your portal views. Change the following properties in the portal-common-messages*.properties file, residing in the ipp-portal-common.jar file of your Stardust installation:
Once you update portal-common-messages*.properties file, the same date format would be reflected across the portal.
To change the property values, unpack the ipp-portal-common.jar file and edit the portal-common-messages*.properties.
For example, the default values for the English resource bundles are:
portalFramework.formats.defaultDateTimeFormat=MM/dd/yy hh:mm a portalFramework.formats.defaultDateFormat=MM/dd/yy portalFramework.formats.defaultTimeFormat=hh:mm a
With these values, a date time entry is displayed in the following way:
Figure: Date Format MM/dd/yy hh:mm a
Changing the defaultDateTimeFormat to:
portalFramework.formats.defaultDateTimeFormat=dd.MM.yy HH:mm
would result in a date time entry displayed in the following way:
Figure: Date Format dd.MM.yy HH:mm
The Help > Documentation link opens a browser window with user documentation for the Stardust Portal.
Figure: Open Online Portal Documentation
To view the entire Stardust documentation, open the Eclipse Help from your Stardust Process Modeler, including search functionality and table of contents (Help > Help Contents > Stardust Documentation).
You can use the Portal Framework provided with the Stardust Portal to modify and extend the content of the portal and add your own application components. Please refer to the chapter Using the Portal Framework of the Stardust Documentation - Programming Guide Using the Portal Framework of the Programming Guide for detailed information.