folder

A work item folder is a work item in a concrete class that inherits from the Work-Folder- class. A folder object holds a collection of one or more other work items (which themselves may be basic work items, other folders, or covers) providing access for analysis and reporting. By convention, the work item ID of folders has the format.

Covers and folders are two built-in facilities that allow your application to support collections of work items. In contrast to covers:

• One work item may be associated with multiple folders, but only with one cover.
• Members of a folder can belong to different work types, which need not belong all in a single work pool.
• The relationships between folder work items and their contents may be many-to-many.

Example

To review or work with a flow rule that creates a folder work item, examine or test the standard flow rule PegaSample-Folder.NewWork.

As a business example, consider a purchasing application where a basic work item is a line item on a single purchase order:

• The purchase order corresponds to a cover object. Every line item belongs to one purchase order.
• Folders organize open purchase order line items by our part number and also by the vendor's part number. A folder work item (in Work-Folder-OurPartNum work type) may be associated with several line items, and one line item can simultaneously belong to a Work-Folder-OurPartNum work item and a Work-Folder-TheirPartNum work item.

Standard rules

These standard rules support folders:

• Work-.AddToFolder flow action — Add a work item to a folder
• Work-.RemoveFromFolder flow actions — Remove a work item from a folder
• Work-Folder-.Review harness — Show folder work item, includes the View Folder Contents button () to access contents
• Work-Folder-.Perform harness — Update folder work item and contents
• Work-Folder-.ReviewforExplore harness — Split-screen presentation
• Work-Folder-.FolderContents section — Show folder contents
• Work-Folder-.NewWork flow — Create a folder

Notes

A folder can be a member of other folder work items.

Instances of the Link-Folder class associate of work items with folders.

Related terms

Open topic with navigation