Overview

Editing in a modal dialog is the preferred method when more than one item or attribute needs to be edited. The dialog control (sap.m.Dialog) interrupts the current app process so that the user can focus on the creation process. Dialogs can be triggered from any part of the product without switching of context.

Editing an item via a modal dialog

When to Use

1
do
false

Recommended

  • Use to edit an entity's attributes.
  • When focus on the editing process is needed.
  • Use dialog editing for mass editing.
  • Use form field validation to make users aware of any errors.
1
dont
false

Not Recommended

  • Avoid using dialog with a wizard for editing.
  • Avoid using dialog editing for an entity when the page context is needed. Use a Flexible Column Layout instead.

See also:

Dialog Creation

Fiori Design Guideline - Form Field Validation

Visual Design Wiki - FlexibleColumnLayout (Fiori 3)

Anatomy

Image
1
14.57; 75.63
Modal Dialog
The container to hold the edited content.
2
17.37; 28.38
Header
Title of the edited Item.
3
27.74; 71.74
Form
Allows users to enter data in a structured way.
4
81.64; 65.54
Finalizing Action
Saves the edited info and closes the dialog.
5
81.44; 73.43
Negative Path
Cancels the editing process and closes the dialog.

See also:

Visual Design Wiki - Page (Fiori 3)

Visual Design Wiki - Dialog (Fiori 3)

Fiori Design Guideline - Select

Fiori Design Guideline - Form / Simple Form

Fiori Design Guideline - Input Field

Actions

The footer contains actions that allow users to save the edited information or to interrupt the process. SAP has defined naming conventions for the most common core actions that are used across all applications and lines of business. See the table below.

<div> <div>Button</div> <div>Type</div> <div>Description</div> </div> <div> <div>Primary Action</div> <div>Emphasized</div> <div>Required. Finalizing action to save the edits.</div> </div> <div> <div>Negative Path</div> <div>Transparent</div> <div>Required. Cancel the editing process and close the dialog.</div> </div> <div> <div>Secondary Action</div> <div>Ghost</div> <div>Optional. When a second action is needed.</div> </div>

See also:

Fiori Design Guideline - Action Placement

Fiori Design Guideline - Terminology for Common Actions