Skip to content

Build the Request Quotations Screen

Key Lesson: Adapt an existing Screen for a downstream Process task by receiving the current business object, rendering its related collection, and returning the updated object through a Process-driving output.

Build the PurchaseQuotationCreate Screen used by Procurement to review an approved Purchase Request, add a quotation entry for each vendor that should receive an RFQ, and submit the updated request.

Before continuing, confirm that the application contains the Quotation and QuotationItem Entities and the Quotation relationships, and that quotation storage and Access Control coverage have been configured. This Screen uses the PurchaseRequest.quotations collection and creates Quotation records. It does not capture QuotationItem records.

1. Copy the Purchase Request Create Screen

Section titled “1. Copy the Purchase Request Create Screen”

Copy the existing PurchaseRequestCreate Screen because it already contains the Purchase Request structure required for this task.

  1. Copy PurchaseRequestCreate and rename the copy PurchaseQuotationCreate.
  2. Select the Screen’s Text component and set Text to Please specify which vendors should be contacted for an RFQ:.
  3. Save your changes before continuing.

For the complete copy procedure, see Copy the entire Screen.

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 request input receives the current approved Purchase Request from the Procurement User Task.

  1. Open the Screen’s Variables tab.
  2. Configure the request variable as follows:
PropertyValue
Namerequest
ContextInput
Type
This.PurchaseRequest
Default expression(Leave blank)
  1. Save your changes before continuing.

Procurement must be able to review the approved request without changing its request details.

  1. Return to the Layout tab.
  2. In the LOGIC section of the Components toolbar section, add a Disable component above the embedded PurchaseRequestInclude Screen.
  3. Drag PurchaseRequestInclude into the Disable component.
  4. Set or confirm the following Disable properties:
PropertyValue
Disabledtrue
Keep disabled if already disabledChecked
  1. Confirm that the embedded Screen retains its request mapping from screen.request.
  2. Leave all other properties at their default values.

  3. Save your changes before continuing.

Add a For Loop that renders the quotation entries stored in screen.request.quotations.

  1. From the LOGIC section of the Components toolbar section, drag a For Loop onto the Vertical layout component.
  2. Configure the For Loop as follows:
PropertyValue
Array
screen.request.quotations
Loop variablequotation
Loop variable type
This.Quotation
  1. Leave all other properties at their default values.

  2. Add a Card component inside the For Loop.
  3. Add an Input component inside the Card.
  4. Configure the Input component as follows:
PropertyValue
LabelVendor name
Binding
quotation.vendor
TypeText
  1. Leave all other properties at their default values.

  2. Save your changes before continuing.

The Add RFQ button appends a new Quotation object to the Purchase Request’s quotations collection.

  1. From the CORE section of the Components toolbar section, add a Button below the For Loop.
  2. Configure the button as follows:
ButtonTabPropertyValue
Add RFQPropertiesPrefix iconadd_circle
PropertiesTextAdd RFQ
AppearanceColorBasic
Events → ClickAction type → Ad-hoc action
screen.request.quotations.push(
  new This.Quotation
)
  1. Leave all other properties at their default values.

  2. Save your changes before continuing.

  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.

Update the copied Submit Request button so Procurement can return the Purchase Request with its quotation entries.

  1. Return to the Screen’s Layout tab.
  2. Select the Submit Request button.
  3. Configure the button as follows:
ButtonTabPropertyValue
Submit RFQsPropertiesPrefix iconsend
PropertiesTextSubmit RFQs
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

PurchaseQuotationCreate displays the approved request as read-only, renders vendor quotation entries from screen.request.quotations, and returns the updated Purchase Request through its Process-driving submit output.