Table Row Edit (Dialog Box) Version 2.0.0.0 Print this Page
Editing Objects Pattern Set
 
Description
Return to Top
Use the Table Row Edit (Dialog Box) pattern when a user needs to edit one or more objects at a time, and the information to be edited will fit in a dialog box. The user can see the base table or tree table while interacting with the dialog box.
 
Pattern Set Decision Table
Return to Top
 

Table Row Edit
(Choice List)

Table Row Edit (Dialog Box)

Table Row Edit
(Page)

Editable Table

Page Edit

Master Detail Edit

Is the editable content limited to one to two attributes?

Yes

No

No

No

No

No

Is the amount of editable content attributes suitable for a dialog box?

No

Yes

No

No

No

No

Does the amount of editable content require a large amount of space or a complex component?

No

No

Yes

Yes

Yes

Yes

Does the user need to see the object attributes being edited in the context of other objects?

Yes

Yes

No

Yes

No

Yes

Do the editable attributes for groups of objects need to be set to the same value?

Yes

Yes

Yes

No

No

No

Is the level of editing suitable for a self-service or novice user?

Yes

Yes

Yes for a
single row,
No for
multiple rows /p>

No

Yes

No

 
Pattern Sample
Return to Top
Single Selection

The user selects a record (table or tree table row) and clicks the Edit icon button.

Figure 1. Selecting a single record to edit
Required Screen Elements
Component Type Required Components Customizable or
Extendable Components
Table or Tree Table A table or tree table is used to display the list of objects. NA
Toolbar

Edit (icon button): Launches a modal dialog box to edit the selected object.

NA

Users are presented with a dialog box where they can edit the record data. Clicking the Cancel button closes this dialog box and all changes. Clicking the Save button commits the changes and closes the dialog box.
Figure 2. Editing and saving the selected record data in a dialog box
Required Screen Elements
Component Type Required Components Customizable or
Extendable Components
Dialog Box Title

Use this format: Edit <Object Type>: <Object Name>

For example: Edit Contact: Eric

Note that if the object name itself is an editable attribute, the change will not be reflected in the dialog box titlel; it applies once the dialog box is saved.

NA
Dialog Box Layout

This pattern provides a container to insert the desired form elements of the transaction.

See the Information Entry Form Basic Form (Dialog Box) pattern.
Form fields may be any standard Web widget (for example, text field, choice list, LOV, radio button, and so on).
Dialog Box Buttons

Include these dialog box buttons:

  • Save and Close: Saves the changes, updates the object information in the base table, and closes the dialog box.
  • Cancel: Cancels the transaction and closes the dialog box.


NA

Multiple Selection

Users first select objects, such as rows in a table or tree table, then click the Edit icon button (or right-click and select Edit from the contextual menu) to launch a dialog box. In the dialog box, users can change all similar attributes to a single value for the selected items. When users click the Save button, all changes are applied to the table or tree table.

Figure 3. Changing similar attributes to a single value for the selected items
Required Screen Elements
Component Type Required Components Customizable or
Extendable Components
Table or Tree Table A table or tree table is used to display the list of objects. NA
Toolbar

Edit (icon button): Launches a modal dialog box to edit the selected objects.

NA
Dialog Box Title

Use this format: Edit <Object Types>

For example: Edit Objectives

Note that specific object names are not listed in the dialog box title because there are multiple objects in this scenario.

NA
Dialog Box Layout

This pattern provides a container to insert the desired form elements.

See the Information Entry Form: Basic Form (Dialog Box) pattern.
Form fields may be any standard Web widget (for example, text field, choice list, LOV, radio button, and so on).
Dialog Box Subheader Title

NA

If selected items appear in the dialog box, they should appear in a region at the top.

Use this format: Selected <Object Names> (for example, Selected Employees).
Dialog Box Table and Toolbar NA

Selected objects from the base table can appear in a table. Object details may include the object name and the values that can be edited.

If a table is added, you should also include a Remove button to enable the user to remove objects from the table.
Dialog Box Buttons

Include these dialog box buttons:

  • Save and Close: Saves the changes, updates the object information in the base table, and closes the window. (See Save Model guidelines for alternate labels that can be used).
  • Cancel: Cancels the transaction and closes the dialog box.
NA
 
Related Guidelines
Return to Top
Buttons Guidelines for buttons in toolbars
Form Layout Guidelines for form layout
Page Actions Usage information and design guidance for buttons at the page level and on dialog boxes
Tree Table Guidelines for the Tree Table component
Tables Guidelines for the table component
Toolbar Guidelines for the toolbar component
Secondary Windows Guidelines for secondary windows and dialog boxes
 
About Oracle | Legal Notices | Terms of Use | Your Privacy Rights