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.
- Copy
PurchaseRequestCreateand rename the copyPurchaseQuotationCreate. - Select the Screen’s Text component and set Text to
Please specify which vendors should be contacted for an RFQ:. -
Save your changes before continuing.
For the complete copy procedure, see Copy the entire Screen.
Attention
2. Configure the request input
Section titled “2. Configure the request input”The request input receives the current approved Purchase Request from the Procurement User Task.
- Open the Screen’s Variables tab.
- Configure the
requestvariable as follows:
| Property | Value |
|---|---|
| Name | request |
| Context | Input |
| Type | |
| Default expression | (Leave blank) |
-
Save your changes before continuing.
3. Make the approved request read-only
Section titled “3. Make the approved request read-only”Procurement must be able to review the approved request without changing its request details.
- Return to the Layout tab.
- In the LOGIC section of the Components toolbar section, add a Disable component above the embedded
PurchaseRequestIncludeScreen. - Drag
PurchaseRequestIncludeinto the Disable component. - Set or confirm the following Disable properties:
| Property | Value |
|---|---|
| Disabled | true |
| Keep disabled if already disabled | Checked |
- Confirm that the embedded Screen retains its
requestmapping fromscreen.request. -
Leave all other properties at their default values.
-
Save your changes before continuing.
4. Render the quotation collection
Section titled “4. Render the quotation collection”Add a For Loop that renders the quotation entries stored in screen.request.quotations.
- From the LOGIC section of the Components toolbar section, drag a For Loop onto the Vertical layout component.
- Configure the For Loop as follows:
| Property | Value |
|---|---|
| Array | |
| Loop variable | quotation |
| Loop variable type | |
-
Leave all other properties at their default values.
- Add a Card component inside the For Loop.
- Add an Input component inside the Card.
- Configure the Input component as follows:
| Property | Value |
|---|---|
| Label | Vendor name |
| Binding | |
| Type | Text |
-
Leave all other properties at their default values.
-
Save your changes before continuing.
5. Add the Add RFQ action
Section titled “5. Add the Add RFQ action”The Add RFQ button appends a new Quotation object to the Purchase Request’s quotations collection.
- From the CORE section of the Components toolbar section, add a Button below the For Loop.
- Configure the button as follows:
| Button | Tab | Property | Value |
|---|---|---|---|
| Add RFQ | Properties | Prefix icon | add_circle |
| Properties | Text | Add RFQ | |
| Appearance | Color | Basic | |
| Events → Click | Action type → Ad-hoc action | |
-
Leave all other properties at their default values.
-
Save your changes before continuing.
6. Configure the Process-driving output
Section titled “6. Configure the Process-driving output”- 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.
7. Configure the Submit RFQs action
Section titled “7. Configure the Submit RFQs action”Update the copied Submit Request button so Procurement can return the Purchase Request with its quotation entries.
- Return to the Screen’s Layout tab.
- Select the Submit Request button.
- Configure the button as follows:
| Button | Tab | Property | Value |
|---|---|---|---|
| Submit RFQs | Properties | Prefix icon | send |
| Properties | Text | Submit RFQs | |
| Appearance | Color | Primary | |
| Events → Click | Action type → Ad-hoc action | |
-
Leave all other properties at their default values.
-
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.