Request Details

View a Request's details.

Overview

Details of a request display the current status of the case, names of case participants, and the option to cancel or rollback a request. Follow these steps to view Request details:

1. Ensure that you are logged on to ProcessMaker Platform.

2. Click the Cases option from the top menu to see cases.

3. From the cards on top, click My Cases, In Progress, Completed, or All Cases card.
4. Click the Case # or Case Title column link to view tasks for the case.

Details

The Details tab displays information depending on the status of the status.

In-Progress

In-Progress Case Detail

The following detail displays about an in-progress Request:

• Cancel Request: The Cancel Request field allows a Request participant or ProcessMaker Platform Administrator to cancel the Request if that Request participant's user account has the appropriate permission to cancel Requests for that Process. If your user account does not have the permission(s) to cancel Requests for that Process, the Cancel Request field does not display. See Cancel a Request.

• Participants: The Participants field displays each Request participant's avatar in the selected Request to that time. Hover your cursor over a user's avatar to view that person's full name.

• In Progress Since: The In Progress Since field displays the date and time the case was created. The time zone setting to display the time is according to the ProcessMaker Platform instance unless your user profile's Time zone setting is specified.

• Process: The Process field displays the process name for the request. Click the Open Process Launchpad link to view the process in the Process Launchpad.

• Requested By: The Requested By field displays the avatar and full name of the person who started the selected Request. Hover your cursor over a user's avatar to view that person's full name.

Completed

Completed Case Detail

The following detail displays a completed Request:

• Participants: The Participants field displays each Request participant's avatar in the selected Request. Hover your cursor over a user's avatar to view that person's full name.

• Completed On: The Completed On field displays the date and time the Request was completed. The time zone setting to display the time is according to the ProcessMaker Platform instance unless your user profile's Time zone setting is specified.

• Process: The Process field displays the process name for the request. Click the Open Process Launchpad link to view the process in the Process Launchpad.

• Requested By: The Requested By field displays the avatar and full name of the person who started the selected Request. Hover your cursor over a user's avatar to view that person's full name.

Canceled

Canceled Case Detail

The following detail displays about a canceled Request:

• Participants: The Participants field displays each Request participant's avatar in the selected Request to the time the Request was canceled. Hover your cursor over a user's avatar to view that person's full name.

• Canceled: The Canceled field shows the date and time the Request was canceled. The time zone setting to display the time is according to the ProcessMaker Platform instance unless your user profile's Time zone setting is specified.

• Process: The Process field displays the process name for the request. Click the Open Process Launchpad link to view the process in the Process Launchpad.

• Requested By: The Requested By field displays the avatar and full name of the person who started the selected Request. Hover your cursor over a user's avatar to view that person's full name.

Error

Case Detail With Errors

The following detail displays about a Request in which an error occurred:

• Participants: The Participants displays each Request participant's avatar in the selected Request to the time of the error. Hover your cursor over a user's avatar to view that person's full name.

• Failed On: The Failed On field shows the date and time in which the Request error occurred. The time zone setting to display the time is according to the ProcessMaker Platform instance unless your user profile's Time zone setting is specified.

• Process: The Process field displays the process name for the request. Click the Open Process Launchpad link to view the process in the Process Launchpad.

• Requested By: The Requested By field displays the avatar and full name of the person who started the selected Request. Hover your cursor over a user's avatar to view that person's full name.

A Request detail with errors has the following actions:

• Manually complete a Request with an error

• Rollback a Request that has an error

• Retry a Request that has a Script or Data Connector error

Manually Complete a Request with an Error

Follow these steps to manually complete a Request with an error:

3. Click Confirm. The status for the selected Request changes from Error to Complete.

Rollback a Request that Has an Error

A user may rollback to return to a previously completed Task when an error has occurred in that Request. The Process Manager receives both an in-application and email notification that the Request is in-error. Rolling the Request back places its status as in-progress instead of in error so that the Process Manager may properly route that Request.

A Request may be rolled back in the following circumstances:

• That user attempting to rollback that Request is a Process Manager.

• The Script Task or Data Connector object that has an error is preceded by a Form Task element during that Request's workflow routing.

• The Script Task or Data Connector object that has an error has a subsequent Form Task element.

• That Request is in an ERROR state.

If a Request with an error does not meet these conditions, the button to rollback that Request is not available.

Follow these steps to rollback a Request that has an error:

3. Click Confirm. ProcessMaker Platform rolls back to the previously completed Task.

4. Fix the error in the affecting Script Task or Data Connector object.

5. Continue that Request's workflow as normal.

Retry a Request That Has an Error

A user may attempt to resume a Request that has a Script Task failed in the following circumstances:

• That user attempting to retry that Request must have the Make this user a Super Admin option enabled on that user account.

• The Request that has an error is not a child Request to a parent Request.

• That Request is in an ERROR state.

• The error in the Request is caused by one or more Script Tasks which is in an ACTIVE, ERROR, or FAILING state.

• The Request does not have any other Tasks that are in ACTIVE, ERROR, or FAILING states.

If a Request with an error does not meet these conditions, the button to retry that Request is not available.

Retrying the Request only attempts to retry the affected Script Task(s) which are in an ACTIVE, ERROR, or FAILING state. If the error for a Request under these circumstances is resolved when retrying that Request, the Request resumes. Its status becomes in-progress. Workflow routes that were in progress prior to the error resume.

If the error for that Request is not resolved, the Request immediately errors again.

Follow these steps to retry a Request that has an error:

3. Click Confirm. ProcessMaker Platform tries to resume that Request.