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.

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:

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 Designer Studio> 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:

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.

Related Topics Link IconRelated terms