The Request for status change is an approval step whereby assigned users review an Issue and approve or reject a request to transition the issue to one of the next valid statuses in the issue type's workflow. This article describes the feature, and explains how to use it.
Prerequisites
- An installation of the SystemWeaver Explorer client (swExplorer).
- You must have "Write" access rights to the CMS project.
- The Request for status change must be configured by a project administrator.
- An installation of SystemWeaver version R43 or later.
How to Access a Request
Issue Editor
If configured for use, the Request for status change pane appears just below the Properties in the Issue Editor when a request is in process.
My Requests
Users who have been assigned to review a status change request can also access the request via the My Requests view under Views and Charts, shown below. The view displays all requests currently assigned to you, and can be used to view, and act on, status change requests assigned to you. The Open issue button will redirect you to the full display of the Issue.
Getting Acquainted with the Options
By default, all of the request options described below are available for an active request.
However, restrictions can be applied to each of them via the configuration. When a restriction is in place, the option will be grayed out and/or unavailable to you. For example:
Adding an Assignee
The Add assignee... button can be used to add one or more assignees to a request that has been started. Each Assignee added to a Request for status change will receive an email notification informing that they have been assigned to approve/reject the request.
Removing an Assignee
To remove an assignee, right-click on the assignee and select Remove assignee.
Completing a Request
Click Complete request to complete the request that is currently in process. This bypasses the review and automatically approves the request, resulting in the issue being moved to the target status.
Aborting a Request
Click Abort request to abort the request that is currently in process. The issue will remain in the source status.
Deleting a Request
Click Delete request to delete the current request permanently from the database. The issue will remain in the source status.
Setting a Due date
Use the optional Due date field to provide a date for when the request is expected to be finished, i.e., approved or rejected. The Clear button clears the date. This option can also be restricted from use.
Reviewing a Request
Users who have been assigned to review a status change request are listed below the Due date field. An assignee, who is logged in and viewing the issue, will see buttons to the right of their name. There are three options available:
 | Approve |
 | Reject |
 | Clear (no selection) |
The Approve and Reject options are configurable. Those available to you will display. Select the desired option to complete your review.
Approving a Request
Available options are Approve or Approve with comment.
Approve
Click Approve to approve the status change without comment.
Approve with comment
Click Approve with comment to approve the status change with a comment.
Rejecting a Request
Available options are Reject or Reject with comment.
Reject
Click Reject to reject the status change without comment.
Reject with comment
Click Reject with comment to reject the status change with a comment.
The Clear button can be used to clear a selection at any time while the request is still active.
Once a request is completed, the Request for status change pane will no longer display and the issue will transition to the "target" status per the workflow configuration logic.