Add One Existing Object Version 2.0.0.0 Print this Page
Add Existing Objects Pattern Set
 
Description
Return to Top
Use the Add Existing Objects pattern set when a user needs to add one valid object as a new row in a table. This pattern set is not appropriate when a user needs to create new objects. If a user needs to create new objects, use the Create Pattern Set.
 
Pattern Set Decision Table
Return to Top
  Add One
Existing Object
Add Many
Existing Objects

Will the user want to add multiple objects to a table at a time?

No

Yes

Is the user doing a lot of detailed table entry?
Yes
No
 
Pattern Sample
Return to Top

To add a new editable row to a table or tree table, the user clicks the Add Row icon button. Clicking this icon button multiple times produces multiple blank rows.

Figure 1. Clicking the Add Row icon button adds new editable rows to the table
Required Screen Elements
Component Type Required Components Customizable or
Extendable Components
Page Buttons

Include these page buttons:

  • Cancel: Cancels the transaction and returns the user to the previous page.
  • Save and Close: Commits the transaction, returns the user to the previous page, and displays a confirmation message. Includes the following action in a drop-down menu:
    • Save (optional): Saves any changes and remains on the current page so that the user can continue editing. This button is available as a menu item off the Save and Close button.

See the Save Model guidelines and Page Actions guideline to select the appropriate button label.

NA
Table, Tree Table A user may edit all fields in the table or tree table.
Product teams can determine whether existing objects and attributes are editable.
Toolbar Add Row (icon button): Creates a new row in the table or tree table. NA

The following example shows a table after a new row has been added.

Figure 2. New table row
Required Screen Elements
Component Type Required Components Customizable or
Extendable Components
Table

The added row should always be visible. The table can scroll if necessary to display the row. The placement of the added row depends on whether the user selected a row when he or she clicked the Add Row icon button. For more information, see the Table Common Actions Guideline .

NA
LOV

The new row must contain a list of value (LOV) choice list so that the user can look up an object or enter the object name, if it is known. When the user moves out of the LOV choice list, other fields in the same row are populated with attributes of that object.

The LOV component supports all of the functionality in the Create in LOV pattern.
NA

When the user populates the LOV choice list, either by entering the value and letting it automatically validate by tabbing out or by launching a search and select dialog box, related object attribute fields are filled.

Figure 3. Completed related object attribute fields
Required Screen Elements
Component Type Required Components Customizable or Extendable Components
LOV

LOV Input

  • Based on user permissions, the attributes that load when a user selects the object may be editable.
  • Product teams can also choose to add additional columns with editable content to be defined by the user.
Table   Product teams can choose to have the data in the row convert to read-only when the user moves to the next row, or product teams can choose to leave the data in the row in an editable state.
 
Related Guidelines
Return to Top
Page Actions Usage information and design guidance for buttons at the page level and on secondary windows
Save Model Save Model information and design guidance for Oracle Fusion applications
Secondary Windows Usage information and design guidance on the toolbar component
Table Overview Overview of the table component and links to other table guidelines
Toolbar Usage information and design guidance on the toolbar component
Tree Table Usage information and design guidance on the tree table component
Tree Usage information and design guidance on the tree component
 
 
About Oracle | Legal Notices | Terms of Use | Your Privacy Rights