You are here: Portals > Composite user portal > Composite user portal basics - Using the Process Work workspace

Composite user portal basics — Using the Process Work workspace

In the composite Manager and User portals, the Process Work workspace is where you update or resolve existing work items. The Process Work bar is available to all the users of the WorkManager or WorkUser portal rules:

Note: In most Pega 7 Platform installations, you can experiment with the PegaSample sample application to create and resolve work items to understand this workspace. This approach avoids any possible interference with application test data or real production data. See Sample application.

Custom worklist formats

Your application can customize the columns and appearance of the worklist by copying and modifying a MyWorklist gadget. See worklist and PDN articles How to customize the worklist display using a JOIN and How to customize the display of a worklist.

Entering the Process Work workspace

Navigation panel — Selecting the work pool name

Depending on the settings in the user portal rule's Spaces tab, the portal may display, near the Pega logo, a drop-down menu where the user can select a work pool to work with.

If the user only has access to a single work pool, the drop-down menu does not need to be displayed.

If you have access to more than one work pool, the current work pool name determines which work types appear in the New... dialog box.

The choice of work pool name does not restrict the types of assignments you can see or process on your worklist.

Work pool names appear on this work pool selector list in the order that the corresponding work pools are listed on the Work Pools array on the Access tab of the access group. If the list is long, consider reordering the Work Pools array to present the applications alphabetically, or in another order meaningful to users.

Navigation panel — Entering new work items

To create a new work item, select a work type from the New drop-down list on the navigation panel:

This list displays all the work types in the current application and work pool. If the work type you want to enter does not appear, select a different application name.

Select a work type from the list. The entry form for that work type appears a new window.

Navigation panel — Finding work

Use the Find area of the navigation panel to search for and access an existing work item or assignment:

portal search variables

When you change any of these settings, the search runs again automatically and displays revised results.

The search results display in a grid. Click the title or ID of any item to open it in a separate window for review or processing.

Process Work gadget — Using the worklist

Users and managers see their worklist at the top of the Process Work gadget. Each row of the worklist identifies one assignment routed to you. Click any row to review or work on the object in a new window.

Columns of the worklist identify aspects of the assignment:

Heading

Description

Urgency A calculated value between 1 (lowest) and 100 (highest) identifying the priority of this assignment (property Work-.pyUrgencyWork). Rows are sorted by decreasing urgency value.

A yellow clock icon () appears after the goal time occurs. This becomes a red clock icon () after the deadline occurs.
ID The unique identifier assigned by the application to this work item. A prefix or suffix portion of this identifier can help users remember the application or work type.
Subject A brief text description of the entire work item, entered when the work item was entered (from property @baseclass.pyLabel).
Status The status of the work item (property Work-.pyStatusWork).
Instructions

A brief characterization of the assignment, the value of the Assign-.pyInstructions property. Usually, this text is set in the Assignment Properties panel of the assignment when editing the flow.

As a best practice, choose instruction text that starts with an imperative verb and conveys to the application user the goal or intent of completing the assignment.

Instruction text that starts with the word Error: indicates a possible application or operational problem. A developer can research and dispose of these conditions, usually allowing processing of the assignment to resume.

See Working with the Assignments in Error report.

Process Work gadget — Manager features

Managers have two additional features in their Process Work gadgets: My Group and Bulk Processing:

manager process work features

The My Group area lets managers review current assignment for individuals and group workbaskets.

The Bulk Processing area lets the manager assign, resolve, or update multiple work items in one step. See Composite Manager portal — How to process assignments in bulk for more information.

Definitions sample application, work item status, transfer, urgency, worklist, work pool name, work type
Related topics About composite portals

About composite portals