Working with interactive Activity Panels

When working on an interactive activity, the activity definition with the corresponding application definition determines the panel that will be shown. The defined panel is loaded into the Activity view and initialized with process data. The user can now work on the activity.

Activity Panel Presentation

If the activity has an in-data-mapping to the data, according input fields are provided.

You can configure the way these fields are displayed in the Portal Configuration view. Refer to chapter Setting Preferences for Activity Panel Presentation Setting Preferences for Activity Panel Presentation for details.

Activities
Figure: Activity View

If the data is of type Structured Data, several fields for all attributes and levels are provided.

Activity Panel with Structured Data fields
Figure: Activity Panel with Structured Data fields

An arbitrary number of activities can be activated in separate Activity Execution views in parallel.

If the Description is added in the Properties page for the activity in modeler, then it is displayed as tooltip text when you hover the mouse over the activity name.

Activity Tooltip Text
Figure: Tooltip Text of an Activity

Restrictions

For the time being, the following restrictions apply to manual activities with structured data:

Maxlength Attributes for Data in Input Fields

The following maxlength attributes apply to input fields according to the input data type:

Data Type Maxlength
Int 10 digits + 1
Short 5 + 1
Byte 3 + 1
Long 19 + 1
Float 39 + 1
Double No maxlength

Using Document Data in Manual Activity Panel

When the document data is mapped to any manual activity, following scenarios can be considered:

In case document data is already associated with some document and user uploads a document from Process Documents pane of the Process Details view, the document uploaded from Process Details view will override the document uploaded from Activity panel.

Also, the changes from Process Details view are immediately reflected to the Activity panel but changes on Activity panel are not reflected to Process Details view until the activity is completed or saved and suspended and Process Details view is refreshed.

Deleting uploaded Documents

When choosing the Delete option on an uploaded document, a confirmation dialog opens to ask whether to remove the document permanently from the process.

Delete Confirmation
Figure: Delete confirmation

In case the current process supports process attachments, you can decide whether to move the document to Process Attachments or to remove it permanently from the process:

Delete Confirmation
Figure: Delete confirmation with move option

If the document is moved to Process Attachments, and this document already exist there, the document to be moved will be appended with a timestamp. For example moving Document.txt and this document already exists, results in the following naming:

Delete Confirmation
Figure: Document name with appended timestamp

Example scenarios

The following behaviour applies to the different scenarios:

Saving Changes to uploaded Documents

You can save changes to an uploaded document in the Document Viewer. In case a document with this name already exists, the document name of the document to be saved will be appended with a timestamp. For example saving License.tif and this document already exists, results in the following naming:

Delete Confirmation
Figure: Document name with appended timestamp

If you do not save changes to the uploaded document and try to perform the operation Complete or Suspend and Save on the manual activity with document data; the following warning message is displayed.

Warning
Figure: Warning Message

The Complete and Suspend and Save operation saves the changes to the document mappings but it does not save the changes to the uploaded document and document meta-data. The changes must be saved on the individual document view. When you select the check box Do not show this message again, the checkbox under the Messages option of the Activity Panel configuration gets cleared. Also, the warning message is never displayed again and the changes to the document do not get saved. For more information, please refer to the section Setting Preferences for Activity Panel Presentation. Setting Preferences for Activity Panel Presentation.

Viewing Tooltip Text on Data

You have the option to view tooltip text to get information on the following data:

Note that the fields with only in-data mapping and value can also have tooltip text. If the value is not specified for the field then the tooltip text is not displayed.

Document Data

The tooltip text is displayed if only the description is added. Also, if in-out data mapping between document data and activity exist then only the tooltip text is displayed.

To view the tooltip text for the document data, perform the following steps:

  1. In the modeler, open the Property page of the document data
  2. Select General and add description in the Description text box
  3. Click Apply and OK
  4. Log in to the Stardust Portal
  5. Hover the mouse over document data icon in the activity panel. The tooltip text gets displayed.

Description for document in tooltip text
Figure: Tooltip Text for Document Data

Primitive Data

The tooltip text is displayed if only the description is added.

To view the tooltip text for the primitive data, perform the following steps:

  1. In the modeler, open the Property page of the primitive data
  2. Select General and add description in the Description text box
  3. Click Apply and OK
  4. Log in to the Stardust Portal
  5. Hover the mouse over primitive data in the activity panel. The tooltip text gets displayed.

Description for primitive data in tooltip text
Figure: Tooltip Text for Primitive Data

Structured Data

The tooltip text is displayed if only the description is added.

To view the tooltip text for the structured data, perform the following steps:

  1. In the modeler, open the Property page of the structured data
  2. Select General and add description in the Description text box
  3. Click Apply and OK
  4. Log in to the Stardust Portal
  5. Hover the mouse over the structured data in the activity panel. The tooltip text gets displayed.

Description for structured data in tooltip text
Figure: Tooltip Text for Structured Data

Activity Panel for 1:N Cardinality of Structured Data

When 1:N cardinality is defined for a field of a structured data, this field is displayed as row in the activity panel with icons to add a new row or delete one or more row(s). For example, a structured data using a field of type Address with cardinality 1:N is displayed in the following way:

Activity Panel for Structured Data with multiple cardinality
Figure: Activity Panel for Structured Data with 1:N cardinality for type Address

Note that when 1:N cardinality is defined for structured data, the table displays one row by default.

To add a row, click the Add icon. A new row with entry fields is added.

Multiple rows for Structured Data with cardinality 1:N
Figure: Multiple rows for Structured Data with cardinality 1:N

To delete one or more row(s), select them in the table and click the Delete icon.

You can change the number of columns used to be displayed in the table layout for multiple cardinality structured data in the Configuration Panel. Refer to section Setting Preferences for Activity Panel Presentation Setting Preferences for Activity Panel Presentation for details.

Error Handling in Activity Panel

Whenever a wrong value is entered in any field of the activity panel, an error is shown in the form. A warning message is displayed at the top of the form.

Activity Panel - Form Error Message
Figure: Activity Panel - Form Error Message

For the table structure, the error message is displayed under the cell value.

Activity - Table Error Message
Figure: Activity Panel - Table Error Message

Activity Panel for Structured Data with Field Level Properties

If field level properties are set for a structured data type, then the activity panel is displayed according to set properties. In the following example, these field level properties are set for a structured data field:

With these properties set, the activity panel is displayed as in the following screenshot:

Activity Panel - Structure Data Field Level Properties
Figure: Activity Panel - Structure Data Field Level Properties

For detailed information and examples, please refer to chapter Structured Data Annotation Properties in the Stardust Online Documentation - Modeling Guide Structured Data Annotation Properties of the Modeling Guide.