Skip to content

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 PurchaseRequestApprove Screen. For the complete copy procedure, see Copy the entire Screen.
  2. Rename the copy PurchaseRequestUpdate.
  3. Select the Screen’s Text component and set Text to Your request has been rejected. Please update and resubmit:.
  4. Save your changes before continuing.

Attention

After copying a screen, review its component references, variables, bindings, expressions, and actions. Unresolved references may appear blank in Lowgile Studio. See Copied Screen References Are Not Updated for more information.

The copied request input receives the current Purchase Request from the Revise PR User Task.

  1. Open the Screen’s Variables tab.
  2. Confirm that request has the following configuration:
PropertyValue
Namerequest
ContextInput
Type
This.PurchaseRequest
Default expression(Leave blank)
  1. 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.

  1. Return to the Layout tab.
  2. Move the embedded PurchaseRequestInclude Screen out of the Disable component and place it above the Disable component.
  3. Confirm that the embedded Screen retains the following configuration:
TabPropertyValue
PropertiesScreenPurchasing.PurchaseRequestInclude
Inputsrequest
screen.request
  1. Move the Approver comment Input into the now-empty Disable component.
  2. Confirm that the Input retains the following configuration:
PropertyValue
LabelApprover comment
Binding
screen.request.comment
TypeText Area
  1. Set or confirm the following Disable properties:
PropertyValue
Disabledtrue
Keep disabled if already disabledChecked
  1. Save your changes before continuing.

The copied Screen already contains a submit output. Change its type so it returns the updated Purchase Request to the current Process task.

  1. Open the Screen’s Outputs tab.
  2. Configure the submit output as follows:
PropertyValue
Namesubmit
Output type
This.PurchaseRequest
Can drive Process forwardChecked
  1. Save your changes before continuing.

Replace the copied approval controls with the single action required by the revision task.

  1. Return to the Layout tab.
  2. Delete the Reject button.
  3. Configure the remaining Approve button as follows:
ButtonTabPropertyValue
ResubmitPropertiesPrefix iconsend
PropertiesTextResubmit
AppearanceColorPrimary
Events → ClickAction type → Ad-hoc action
await output.submit(screen.request)
  1. Leave all other properties at their default values.

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