Standard icons

Standard variations of pxIcon are provided. Each is preconfigured with an icon, tooltip, and action. As a best practice, use these standard rules to ensure correct appearance and behavior.

If the action is not included in the list, keep pxIcon and use the Parameters dialog to configure the control.

This table below provides the icon name, the description of action invoked when clicked, and the standard icon control, which contains its parameters.

Icon Name

Icon and Action

Control Rule

Add Item

Adds (above or below) a row to a grid, tree, or tree grid layout

pxIconAddItem
Add New Work

Adds a new work item using the primary page data. Saves the new work item on the deferred list.

pxIconAddNewWork
Attachments

Presents a list of work item attachments, so users can view or add attachments. This icon appears only for users who hold the Work-.AccessAuditTrail privilege.

pxIconAttachments
Blank

No action is associated with it.

pxIcon
Cancel

Closes the current form without applying any changes.

pxIconCancel
Contents

For a cover work item, changes the form to allow users to view and navigate among the covered work items. You can override a standard list view rule to control details of this display.

pxIconContents
Delete Item

Removes a row in a grid, tree, or tree grid layout.

pxIconDeleteItem
Enable Action Section

Presents the user form in review-only mode; inputs allowed in the action section only.

pxEnableActionSection
Expand/Collapse

Redraw the form with all areas fully expanded.

pxIconExpandCollapse
Explore

For a folder work item, changes the form to allow users to view and navigate among the associated work items.

pxIconExplore
Finish Assignment Submits changes and marks this assignment as complete. pxIconFinishAssigment
Get Next Work

Cancels any unsubmitted changes and finds the most important assignment to work on next.

pxIconGetNextWork
History

Displays the work item history, for users who hold the Work-.AccessAuditTrail privilege.

pxIconHistory
Print

Starts browser-based printing, which prints the current user form as displayed. This printout may not include desired fields and may use colors, fonts, and labels that are not desired in hard copy prints.

pxIconPrint
Reopen Work Item

Reopens a resolved work item, for users who hold the Work-.Reopen privilege. Runs the standard activity Work-.Reopen or your application override.

pxIconReopenWorkItem
Review

Presents the user form in review-only mode, allowing no updates.

pxIconReview
Save

Saves the work item with Submit.

pxIconSave
Show Flow Location

Known as the Where-am-I? icon marks the location of the current assignment with an arrow. This icon appears only to users who hold the Perform privilege.

Note: If the harness is a New harness — one supporting the entry of new work items — do not include the Show Flow Location icon in most cases. A flow execution doesn't start until users submit a user form. If you do include this icon in a New harness, use a when condition rule to disable the icon at runtime unless a non-blank work item ID exists.

pxIconShowFlowLocation
Show Reopen Screen

Shows the form in review mode but allows users to reopen a resolved work item. Available to users who hold the Work-.Reopen privilege. Runs the standard activity Work-.Reopen or your application override.

pxIconShowReopenScreen
Spell Checker

Enables spell-checking. See How to enable spellchecking in user forms.

pxIconSpellChecker
Update

Redraws the form in update mode. Appears only for users who hold the Work-.Update privilege. Update mode allows changes to values that appear in sections other than the TAKE ACTION section.

This capability is not desirable in all applications, as it allows users to overwrite values entered previously, perhaps by other users.

The Apply button sends changed user inputs to the server, but does not commit these changes. The user must select and complete a flow action to save the changes. See Understanding transactions in flow executions.

pxIconUpdate