Build the Update Request Screen
Key Lesson: Reuse a task Screen safely by preserving its Process input, changing only the editability and output behavior required by the next task.
Build the PurchaseRequestUpdate Screen that Requesters use to revise and resubmit a rejected purchase request.
The Screen begins as a copy of PurchaseRequestApprove because both tasks use the same Purchase Request details and comment binding. This procedure changes only the controls and behavior required for revision.
1. Copy the Approve Request Screen
Section titled “1. Copy the Approve Request Screen”- Copy the PurchaseRequestApprove Screen. For the complete copy procedure, see Copy the entire Screen.
- Rename the copy
PurchaseRequestUpdate. - Select the Screen’s Text component and set Text to
Your request has been rejected. Please update and resubmit:. -
Save your changes before continuing.
Attention
2. Confirm the request input
Section titled “2. Confirm the request input”The copied request input receives the current Purchase Request from the Revise PR User Task.
- Open the Screen’s Variables tab.
- Confirm that
requesthas the following configuration:
| Property | Value |
|---|---|
| Name | request |
| Context | Input |
| Type | |
| Default expression | (Leave blank) |
-
Save your changes before continuing.
3. Make the request editable and keep the comment read-only
Section titled “3. Make the request editable and keep the comment read-only”The copied Screen currently disables the request details and leaves the Approver comment enabled. Reverse that arrangement for the Requester.
- Return to the Layout tab.
- Move the embedded
PurchaseRequestIncludeScreen out of the Disable component and place it above the Disable component. - Confirm that the embedded Screen retains the following configuration:
| Tab | Property | Value |
|---|---|---|
| Properties | Screen | Purchasing.PurchaseRequestInclude |
| Inputs | request | |
- Move the Approver comment Input into the now-empty Disable component.
- Confirm that the Input retains the following configuration:
| Property | Value |
|---|---|
| Label | Approver comment |
| Binding | |
| Type | Text Area |
- Set or confirm the following Disable properties:
| Property | Value |
|---|---|
| Disabled | true |
| Keep disabled if already disabled | Checked |
-
Save your changes before continuing.
4. Confirm the Process-driving output
Section titled “4. Confirm the Process-driving output”The copied Screen already contains a submit output. Change its type so it returns the updated Purchase Request to the current Process task.
- Open the Screen’s Outputs tab.
- Configure the
submitoutput as follows:
| Property | Value |
|---|---|
| Name | submit |
| Output type | |
| Can drive Process forward | Checked |
-
Save your changes before continuing.
5. Configure the Resubmit action
Section titled “5. Configure the Resubmit action”Replace the copied approval controls with the single action required by the revision task.
- Return to the Layout tab.
- Delete the Reject button.
- Configure the remaining Approve button as follows:
| Button | Tab | Property | Value |
|---|---|---|---|
| Resubmit | Properties | Prefix icon | send |
| Properties | Text | Resubmit | |
| Appearance | Color | Primary | |
| Events → Click | Action type → Ad-hoc action | |
-
Leave all other properties at their default values.
-
Save and close the editor.
Outcome
PurchaseRequestUpdate lets the Requester edit the Purchase Request while the existing rejection comment remains read-only. Resubmit returns the updated This.PurchaseRequest through the Process-driving submit output.