Use harnesses to define the appearance and processing of user forms used in your application to create work items and process assignments.
Pega 7 Platform includes more than a dozen standard harness forms for entering, reviewing, updating, and processing work items and assignments. Your application can override the standard rules to extend and tailor them to specific needs.
Before creating or editing harness, section or flow action forms, set the Using skin preference to the skin that application users are expected to use. This provides the closest approximation during development of the run-time look and feel of the form.
You can use harnesses to define composite portals, as well as user forms. For this advanced special use, see How to create a composite portal.
On the Design tab, each harness references one or more sections that define the run-time presentation of the work item. You can directly edit these sections in the Harness form, using these controls and layouts. When you save the harness, the updated sections are also saved.
Layout |
|||||
Basic |
|||||
Advanced |
|||||
Work object forms defined by harnesses are typical, but not required, elements of a Pega 7 Platform application. Some business process management applications use an external portal or external system and call Pega 7 Platform services to create work items, advance them through a flow, perform flow actions, and so on. The Process API is a collection of standard activities that apply to the Work- base class to support such headless applications.
Each flow rule that creates a new work item identifies a harness to capture initial information about that work item.
Standard activities that apply to the Work- class look (using rule resolution) for harnesses with specific names, such as New
, Perform
, and Review
. To display a user form defined by a harness, call the standard @baseclass.Show-Harness activity in your activity.
Harnesses that allow users to select from multiple flow actions (often called Perform harnesses) contain an action section. See Presenting Flow Actions.
For basic information about using user forms defined by harnesses from an application user perspective, see Working with user forms.
Some rule forms are defined through harness and sections. This capability is reserved.
Use the Application Explorer to access the harnesses that apply to the work types in your application. Use the Records Explorer to list all the harnesses available to you.
Harnesses are instances of the Rule-HTML-Harness class. They are part of the User Interface category.