Skip to content

Update Sidebar Navigation

Key Lesson: Connect an application sidebar navigation item to a task-facing Screen.

Update MainLayoutSidebar so users can open PurchaseRequestCreate from the Purchasing application’s navigation.

  1. In Design, open the MainLayoutSidebar Screen.
  2. Open the Layout tab.
  3. Configure the existing sidebar components as follows:
ComponentPropertyValue
Functional AreaTextPurchase Request
Text in the first Navigation ItemTextCreate New
First Navigation ItemLink to Screen
Purchasing.PurchaseRequestCreate
  1. Save your changes before continuing.

The application sidebar now exposes the first purchase request workflow entry point. The verification section below checks the Screens, navigation, build, and initial user interface together.

Verify the first two Screens before extending the Purchasing application. This checkpoint covers only the reusable Include Screen, the Create Screen, its navigation entry, and the first working request-entry controls.

  1. Open MainLayoutSidebar in Design.
  2. Confirm that the Functional Area text is Purchase Request.
  3. Confirm that the first Navigation Item displays Create New and links to Purchasing.PurchaseRequestCreate.
Expected result:

The application navigation contains a Purchase Request group with a Create New item linked to the PurchaseRequestCreate Screen.

If this does not happen:

If the labels or link differ, compare the components with Update Sidebar Navigation and save the Screen again.

  1. Return to the main Studio editor.
  2. In Design, locate the Purchasing application.
  3. Wait for the application name to turn green.
  4. Select the Purchasing application, then select Play.
Expected result:

The Purchasing application builds successfully and opens without a runtime error.

If this does not happen:

If the application is blue, wait for the build to finish. If it turns red, select the red exclamation mark and correct the reported Screen, variable, or binding error. If the application builds but does not open, check Monitor → General Log and the browser console for the reported runtime error.

  1. In the application sidebar, expand Purchase Request.
  2. Select Create New.
  3. Observe the application shell and the main content area.
Expected result:

The application displays one header and one sidebar. The main content area shows:

  • The instruction to enter information for a new purchase request.
  • The Cost Center dropdown.
  • The Add Item button.
  • The Submit Request button.
If this does not happen:

If Create New does not open the Screen, confirm that its navigation item links to Purchasing.PurchaseRequestCreate. If a second header or sidebar appears in the content area, confirm that PurchaseRequestInclude does not retain its own MainLayout; see Duplicate Navigation Appears in an Embedded Screen.

  1. Open the Cost Center dropdown.
  2. Confirm that it contains Marketing, Operations, Finance, and IT, then select one value.
  3. Select Add Item.
  4. Enter a description, quantity, and budget amount in the generated item controls, then select a currency.
Expected result:

The Cost Center selection remains visible. Add Item creates one editable purchase request item with Description, Quantity, Budget Amount, and Currency controls, and the entered values remain visible.

If this does not happen:

If the Cost Center values are missing, verify the Purchasing.CostCenter static entity and the screen.request.costCenter binding. If Add Item does not create editable controls, confirm that the For Loop uses screen.request.items, its controls bind to the loop-scoped item, and the button action adds a new This.PurchaseRequestItem to the collection.

The Submit Request button is tested later in Connect and Test Request Submission, after its Process-start action and persistence route are configured.

Use this checklist to confirm that this stage is complete.