ProcessMaker API Documentation
Script Central

Summary for Canceled Requests

Learn what information displays in summaries for canceled Requests.

Overview

Follow these steps to view a summary for a canceled Request:

  1. Ensure that you are logged on to ProcessMaker.

  2. View one of the following Requests pages:

  3. Do one of the following:

    • From the # column in the Request page, click the Request number associated with the Process that you want to view. That Request's summary displays.

    • Click the Open Request iconfor a Request. That Request's summary displays.

Values in the Request

The Summary tab displays the summary of information entered into the Request to the time of its cancellation. Request participants manually enter information into ProcessMaker Screens.

The Summary tab displays the JSON-formatted key/value pairs in tabular format that represent ProcessMaker Screen control data. Information is displayed:

  • Key: The Key column displays the JSON key name that represents the ProcessMaker Screen control name the Request participant entered data. For example, a Rich Text control to enter your company's name could have a Variable Name setting value of companyName which would display in the Key column here.

  • Value: The Value column displays that key's value as entered by a person manually interacting with a form. For example, a Text control to enter your name could have the value John Doe which would display in the Value column here.

The Summary tab may also display a message about the canceled Request. This message is a ProcessMaker Screen configured to display when Requests for a specific Process are canceled.

ProcessMaker Screen displaying a message when Requests for a specific Process are canceled.

Below the Summary tab, the history of the Request displays all Request actions. See Request History.

Control how tabular information displays, including how to sort columns or how many items display per page.

Completed Tasks Summary

The Completed tab displays the summary of all Tasks Request participants completed to the time the selected Request was canceled.

"Completed" tab for a canceled Request's summary

The Completed tab displays the following summary in tabular format about completed Tasks Request participants completed to the time the Request was canceled:

  • #: The # column displays the Task ID associated with its Process. Each time that Task is assigned to a Request participant, the ID for that Task increments by one.

  • Task: The Task column displays the name of each completed Task in the selected Request.

  • Assigned: The Assigned column displays the username's avatar to whom the Task was assigned. Hover your cursor over a user's avatar to view that person's full name.

  • Due: The Due column displays the date the Task was due. The time zone setting to display the time is according to the ProcessMaker instance unless your user profile's Time zone setting is specified.

Below the table, the history of the Request displays all Request actions to the time the selected Request was canceled. See Request History.

There Are No Completed Tasks?

If the selected Request has no completed Tasks, the following message displays: No Data Available.

Display Information the Way You Want It

Control how tabular information displays, including how to sort columns or how many items display per page.

Files Associated with the Request

The Files tab displays the summary of all files associated with the Request to that time. The Files tab only displays in that Request summary if one of the following occurs:

  • At least one file has been uploaded to that Request.

  • A PDF Generator connector in that Request has automatically generated a PDF of a Display-type ProcessMaker Screen. Note that to use the PDF Generator connector, the PDF Generator package must be installed in your ProcessMaker instance. The PDF Generator package is not available in the ProcessMaker open-source edition. Contact ProcessMaker Sales or ask your ProcessMaker sales representative how the PDF Generator package can be installed in your ProcessMaker instance.

"Files" tab for a canceled Request's summary

The Files tab displays the following summary in tabular format about the files associated with the Request:

  • File Name: The File Name column displays the name of each file associated with the selected Request. Click the file name to download it to your local computer or network location.

  • MIME Type: The MIME Type column displays the MIME type for the associated file.

  • Created At: The Created At column displays the date the file became associated with the selected Request. The file became associated with the Request when the person who attached it submitted the ProcessMaker Screen to which the file was uploaded. The time zone setting to display the time is according to the ProcessMaker instance unless your user profile's Time zone setting is specified.

Below the table, the history of the Request displays all Request actions to the time the selected Request was canceled. See Request History.

Forms Associated with the Request

The Forms tab displays the ProcessMaker Screen associated with each Task that each Request participant submitted in the Request to that time. For example, if a Request participant entered information into a ProcessMaker Screen, all Request participants can view the Request data that the Task assignee entered.

"Forms" tab for a canceled Request's summary

The Forms tab displays the following summary in tabular format about submitted ProcessMaker Screens by Request participants to that time in the Request:

  • Screen: The Screen column displays the name of each submitted ProcessMaker Screen in the selected Request.

  • Description: The Description column displays the description of each ProcessMaker Screen.

View a ProcessMaker Screen and Its Submitted Request Data

To view a ProcessMaker Screen and the Request data submitted by a Request participant, click the Details icon. The submitted ProcessMaker Screen displays.

Click the Details iconagain to hide the displayed ProcessMaker Screen and its Request data.

To print a ProcessMaker and its Request data, click the Print icon. A print preview displays in a new browser window from which you can select an accessible printer.

Below the table, the history of the Request displays all Request actions. See Request History.

There Are No Forms?

If the selected Request has no ProcessMaker Screens with submitted Request data, the following message displays: No Data Available.

Summary

Each canceled Request displays a summary of the Request to the time the Request was canceled.

Request participant summary for a canceled Request

The following summary displays about a canceled Request:

  • 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.

  • Child Requests: The Child Requests field displays any child Requests associated with this Request, referred to as the parent Request when a child Request exists. A child Request is one from which this Request automatically started as designed in its associated Process. All child Requests have their own statuses since each routes independently of their parent Request. Click the link for any child Request to view the Request summary for that child Request. For example, a child Request represents a Sub Process. If there are no child Requests associated with this Request, the Child Requests field does not display. The status icon displays beside each child Request. See View Your Requests for descriptions of each status icon.

  • Parent Request: The Parent Request field displays the parent Request associated with this Request, referred to as the child Request when a parent Request exists. The parent Request is one that automatically started this Request as designed in its associated Process. The parent Request has its own status since it routes independently of its child Request(s). Click the link for the parent Request to view the Request summary for that Request. For example, a parent Request represents the main Process that started a Sub Process request. If there is no parent Request associated with this Request, the Parent Request field does not display. The status icon displays beside the parent Request. See View Your Requests for descriptions of each status icon. Below is an example of a parent Request in a Request summary.

  • 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.

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

Request History

Below the tabular information summarizing the Request displays that Request's history: all Request actions to that time. The oldest Request actions display at the top of the Request history.

Request history displays all actions in a Request, with the oldest actions at the top

The following information displays about each event in the Request history:

  • Request participant: The Request participant who performed the action is represented by his or her avatar. Hover your cursor over a user's avatar to view that person's full name. If the ProcessMaker system performed an action by running a ProcessMaker Script or other automatic function, that action is represented by "S" avatar.

  • Date and time the action occurred: To the right of the Request participant displays the date and time the Request action occurred. The time zone setting to display the time is according to the ProcessMaker instance unless your user profile's Time zone setting is specified.

  • Description of the action: To the right of when the Request action occurred displays a description of that action. The ProcessMaker system generates this action description.

Related Topics