Work item status

The standard property Work-.pyStatusWork is known as the work item status. This value defines whether the work item is open or resolved. The value of this property is a primary indicator of the progress of the item towards resolution. Values are restricted and controlled, and are changed only through specific mechanisms.

Don't confuse work item status with assignment status, a different property.

Basics

Resolved work items identify completed work and are ordinarily not modified by any later processing, unless the work item is reopened. The following values are typical for this property:

• New — Not yet reviewed or qualified
• Open — Responsibility for processing is with the processing organization
• Pending — Responsibility for processing is currently with an external organization
• Pending-PolicyOverride — Work is suspended pending a review of a potential violation of policy
• Resolved-Duplicate — Resolved, as this work item is judged to be a duplicate of another work item
• Resolved-Rejected — Resolved, not accepted
• Resolved-Revoked — Resolved, reviewer has ended processing
• Resolved-Completed — Resolved, work completed

The last three values indicate that the work item is resolved, meaning that no additional processing is expected. You can define more status values, but start each value with one of the words New, Open, Pending, or Resolved, with initial capitals as indicated.

Values for this property are defined through field values rules; several standard values are defined.

The control rule WorkStatus supports localization of the status value on displays, through field value rules.

Status Values landing page tab

The Status Values landing page tab shows the values of this property for your current application. To see this list of values, select > Process & Rules > Processes > Status Values.

Ticket activation

When a work item is first resolved, the system activates a ticket named Status-Resolved. This ticket may appear in multiple workflows, so that your application can promulgate news of the work item resolution to other business processes as appropriate.

Standard activities

In an activity, don't use the Property-Set method in an activity to change a work item status. Call the standard activity Work-.UpdateStatus, which changes the status directly, and calls standard activities RecalculateAndSave and Resolve as appropriate. This activity is of type Utility.

The status may also change when your flow uses these two standard activities:

• Work-.WorkBasket — Places the assignment in a workbasket and calls Work-.UpdateStatus. This activity is of type Assign.
• Work-.Worklist — Places the assignment on a worklist and calls Work-.UpdateStatus. This activity is of type Assign.

All three activities update the work item history to reflect the status change and perform other housekeeping.

Elapsed time in status

The standard properties Work-.pyElapsedStatusNew, pyElapsedStatusOpen, and pyElapsedStatusPending are automatically maintained by a standard Declare Trigger rule. These properties contain cumulative times (in seconds) that a work item had a status value that started with the literal text "New," "Open," or "Pending," respectively.

	entry, open, pending, problem assignment, reject, reopen, resolution, ticket, work item
	About Field Value rules
	Standard properties in the Work- base class

Definitions