Updated: January 24, 2022

Simple Objects (Create, Edit)

Intro

Use the flows described below to create and edit simple objects. All the information for a simple object appears on a single page. The flows use standard message and draft handling. For the delete flow, see Delete Objects.

Create

Full Screen Layout

If your app runs in full screen mode, meaning that one page is shown at a time, the standard create flow is as follows:

Create a simple object (full screen layout)
Create a simple object (full screen layout)

  1. In a list report, the user chooses Create.
    An empty object page appears with the title New <object type> (here: New Sales Order). The footer toolbar contains the finalizing Create action and Cancel.
  2. After entering all the data, the user chooses Create.
    You have the following flow options, depending on your use case:

    1. The standard flow shows the object in display mode and a message toast.
      If required by the use case, you can also keep the object in edit mode.
    2. If your use case involves creating several objects in succession, you can also navigate back to the list report. The message toast is shown on the list report and an indicator highlights the new item.
  3. Choosing Cancel opens a confirmation popover and the user can opt to discard the draft. In this case, the system navigates back to the list report.

Flexible Column Layout

If your app runs in the flexible column layout and the user chooses Create on the object page, the display is as follows:

  • The first column shows the updated list report with the focus on the newly created item (as for 2b).
  • The second column shows the object page in display mode plus the message toast (as for 2a).

If the user confirms Cancel, the second column is closed.

Edit

Information
If only a few sections are editable, set only these sections to edit mode, or open a dialog for editing. For more information, see Parts of an Object.

Full Screen Layout

You can choose between the following edit flows for the entire page:

  • The standard flow is to navigate from a list report to the object details. The object is shown in display mode. Choosing Edit in the header toolbar of the object page opens the object in edit mode.
    See also: Start editing from object page
    As an alternative, you can open the object directly in edit mode.
  • In a list report, the user selects an object and chooses Edit in the list report toolbar. This opens the selected object in edit mode.
    See also: Start editing from list report

Start editing from object page

Edit a simple object starting from the object page (full screen layout)
Edit a simple object starting from the object page (full screen layout)

  1. From the list report, the user navigates to the details of an object.
    The object page features a header toolbar with an Edit button. The title of the page is <object type> (here: Sales Order).
  2. The user chooses Edit.
    The object page changes to edit mode, showing a footer toolbar containing the finalizing Save action and Cancel. The title does not change.
  3. After updating the data, the user chooses Save.
    You have the following flow options, depending on your use case:
  1. The standard flow shows the object in display mode and a message toast.
  2. If your use case involves editing several objects in succession, you can also navigate back to the list report. The message toast is shown on the list report and an indicator highlights the updated item.
  • Choosing Cancel opens a confirmation popover and the user can opt to discard the changes. The object then switches to display mode. If required by the use case, the system can also navigate back to the list report.

Start editing from list report

Edit a simple object starting from a list report (full screen layout)
Edit a simple object starting from a list report (full screen layout)

  1. In a list report, the user selects an object and chooses Edit.
    The object page features a footer toolbar containing the finalizing Save action and Cancel. The title of the page is <object type> (here: Sales Order).
  2. After updating the data, the user chooses Save.
    You have the following flow options, depending on your use case:

    1. The standard flow shows the object in display mode and a message toast.
    2. If your use case involves editing several objects in succession, you can also navigate back to the list report. The message toast is shown on the list report and an indicator highlights the updated item.
  3. Selecting Cancel opens a confirmation popover, and the user can opt to discard the changes. The object then switches to display mode. If required by the use case, the system can also navigate back to the list report.

Flexible Column Layout

If your app runs in the flexible column layout, and the user chooses Save on the object page, the display is as follows:

  • The first column shows the list report with the focus on the updated object.
  • The second column shows the object page in display mode plus the message toast.

If the user confirms Cancel, the second column shows the object in display mode.

Related Links

Elements and Controls

Implementation