This article describes the global flow for creating and editing items using standard message handling and draft handling.

If you need the flow for deleting items, see Delete Objects.

Create Items

The steps below describe the global flow for creating items on a subpage. The main page must be in edit mode.

Full Screen Layout

1. On the main object page, the user chooses Create in the toolbar for the items table.
   An empty subpage appears with the title New <item> (for example, New Sales Order Item). The footer toolbar contains an Add action and Cancel.
2. After entering all the data, the user chooses Add.
   The standard flow navigates back to the main object page. The new item is highlighted in the items table.
   Depending on your use case, you have the following alternatives:
   • You can keep the subpage in edit mode. In this case, the title changes to reflect the specific item. For example, Sales Order Item (10).
   • If the user needs to create several items in succession, you can offer the action Add and Next in the footer toolbar of the subpage. This opens a new, empty subpage.

3. Choosing Cancel opens a confirmation popover and the user can opt to discard the item. In this case, the system navigates back to the main object page.

The item is only saved to the database when the user chooses Save on the main object page.

Flexible Column Layout

In the flexible column layout, the standard flow is as follows:

• Choosing Add on the subpage closes the subpage column. The new item is highlighted in the items table.
• Confirming Cancel closes the subpage column.
• Choosing Add and Next on the subpage opens a new, empty subpage in the subpage column.

Edit Items

The steps below describe the global flow for editing items on a subpage. The main page must be in edit mode.

Full Screen Layout

1. From the main object page, the user navigates to the details of an item.
   The subpage opens in edit mode. The title of the subpage reflects the current item, for example, Sales Order Item (10). The subpage shows a footer toolbar containing the Apply action and Cancel.
2. After updating all the data, the user chooses Apply.
   The modified item is highlighted in the items table.
   Depending on your use case, you have the following alternatives:
   • You can keep the subpage in edit mode.
   • If the user needs to edit several items in succession, you can offer the action Apply and Next in the footer toolbar of the subpage. This opens the subpage for the next item in edit mode.
   • You can show up and down arrows for navigating to the previous or next item in edit mode.
3. Choosing Cancel opens a confirmation popover and the user can opt to discard the changes to the item. In this case, the system navigates back to the main object page.

The item is only updated on the database when the user chooses Save on the main object page.

Flexible Column Layout

In the flexible column layout, the standard flow is as follows:

• Choosing Apply on the subpage closes the subpage column. The modified item is highlighted in the items table.
• Confirming Cancel closes the column subpage.
• Choosing Apply and Next on the subpage opens the next item in edit mode in the subpage column.

Message Handling

On the main page, validation is triggered on focus out and when the user selects Save. On a subpage, validation is triggered on focus out and when the user selects Add or Apply.

If errors occur, a message popover appears:

• On the main page, the message popover displays errors coming from the main page and error summaries coming from all related subpages. To help the user find the item and solve the issue, an indicator in the line item of the table shows which subpage contains errors. In addition, the errors in the message popover are grouped by page, tab, and section. For more information about how error messages are grouped, see message popover components.
• On a subpage, validation only applies for the current subpage. The message popover lists only errors related to this subpage.

Related Links