You are here: Reference > Rule types > Defining your application harnessess

About Harnesses

  1. About 
  2. New 
  3. Design 
  4. Display Options 
  5. Scripts and Styles 
  1. Pages & Classes 
  2. Advanced 
  3. History 
  4. More... 

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 Tab  


Button Check box Calendar Icon  
  Input Box Label Radio Buttons TextArea  




AutoComplete Chart Data Field List to List  
  Menu Bar Paragraph Smart Label Rich Text Editor  
  Information Mashup        

Applications without user forms

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.

Where referenced

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.

Action section

Harnesses that allow users to select from multiple flow actions (often called Perform harnesses) contain an action section. See Presenting Flow Actions.

User interaction with user forms

For basic information about using user forms defined by harnesses from an application user perspective, see Working with user forms.

Rule 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.

Related Topics Link IconRelated information

User Interface category