Error Version 2.0.0.0Print this Page
Message Pattern Set
 
Description
Return to Top

Error messages are triggered by validation of data formatting, user interface (UI), or business rules. The messages tell users of data inaccuracies when completing an editable field, saving a page, navigating from the page, or other actions, as well as how to fix the errors. Messages may be at the component level (and therefore the list level) or at the page level, shown either as a dialog box or inline on the page.

Inline messages are set using the inline attribute on the Application Development Framework (ADF) af:messages component.

Error messages may also inform users when an application or process encounters an error that was not caused by the users themselves and are outside their control to prevent.  These error messages appear in modal dialog boxes at the page level only and require help desk intervention.

Important: A page cannot contain a combination of inline or dialog box-based messages. The choice is determined at the page level by the ADF af:messages component, which allows only one type on each page. Individual messages on the page use the af:message component.

With the exception of application error messages, all dialogs boxes are modeless.

 
Pattern Set Decision Table
Return to Top
 

Error

Warning

Information

Processing

Confirmation

Tells users that the data that they entered in a field violates a business, UI, or formatting rule, and explains how to correct the error.

Or

Tells users that an application error has occurred that was not due to their actions and that correcting the error will require help desk intervention.

Yes

No

No

No

No

Tells users about important consequences of a validation of a UI or business rule, or a process execution, that they must be aware of either now or later in the taskflow.

Or

Tells users about potentially dangerous or destructive consequences of their actions or the application's progress.

May include a direct question asking users to decide between alternative actions before proceeding with their tasks.

No

Yes

No

No

No

Tells users about the status or changes of a business object, a page, or the application itself that was not initiated by the users and does not require any immediate action to be taken by them.

No
No
Yes
No
No
Tells users about the progress of an action or a process that they or the application initiated.
No
No
No
Yes
No
Tells users when an action or process that they or the application initiated has completed.
No
No
No
No
Yes
 
Pattern Sample
Return to Top

Component and List Inline Error Message

For information on individual component and ADF converter and validator messages, see the Component section (on the main page of the Message Pattern Set).

When users perform a page action, errors are listed at the top of the page . Components with errors are outlined with red borders. Focus is given to each editable field individually at the component level from the listed components, or directly. The component-level note dialog box enables users to also navigate to other component-level messages .

Inline List Showing All Error Messages
Figure 1. Inline list showing all error messages
Component-level Error Message
Figure 2. Component-level error message

When users perform a page action, errors are listed in a modeless dialog box. Components with errors are outlined with red borders. Focus is given to each editable field individually at the component level from the listed components or directly. This dialog box enables users to also navigate to other component-level messages and to return to the list in the dialog box by clicking the All button.

Dialog List Showing All Error Messages
Figure 3. Dialog box list showing all error messages
Component-level Error Message
Figure 4. Component-level error message

Components Required

Required Screen Elements for Message List Errors
Component Type Required Components Customizable or Extendable Components
Message Icon Button

Error Qualifier

error_qualifier.png The error icon button precedes the message title. NA
Message Title Use this title: Error NA
Message Region

The message content contains three sections:

  • Introductory message: Use this wording: Messages for this page are listed below.

This wording is provided by ADF. Teams should not change this message.

  • Component name: A link to the name of the component. The component ID should be used to ensure the name of the link matches the name of the component.
  • Error qualifier icon button.
  • Message summary: A short description of each error taken from the Message Text component. Use this format: <Error message text.> <Error Code)>
Other messages may be added to the dialog box (for example, a global error may be added before the introductory message). See the Messaging Usage Guideline .
NA
Dialog Box Buttons

Close icon button: Clicking this icon closes the dialog box.

OK: Clicking this button closes the dialog box.

NA
ADF Component

af:messages

NA

Required Screen Elements for Component Errors
Component Type Required Components Customizable or Extendable Components

Error Icon Button

Error Qualifier

error_qualifier.png The error icon button precedes the note title. NA
Note Title Use this title: Error NA
Note Region

The message content contains:

  • Message summary: A short description of each error taken from the Message Text component. Use this format: <Error message text.> <(Error Code)>
  • Message user or admin detail: Optional additional details intended for end users or administrative users.
  • Message cause: Optional cause of the error message.
  • Message user action or admin action: Optional action required to be taken by end users or administrative users to resolve the message
NA
Note Buttons Traversal and All buttons are shown if more than one component message is active. NA
ADF Component af:messages NA

Page-Level Error Message

These messages may be in dialog boxes or inline.

This page-level inline error message appears when an expenses report is submitted without items having been entered.

Page-level Inline Error Message
Figure 5. Page-level inline error message

This page-level error message appears in a dialog box because of a business rule conflict between dates when the user publishes the progress for a project.

Page-level Error Message Dialog
Figure 6. Page-level error message dialog box

Components Required

Required Screen Elements for Page-level Errors
Component Type Required Components Customizable or Extendable Components
Message Icon Button

Error Qualifier

error_qualifier.png The error icon button precedes the message title. NA
Message Title Use this tite: Error NA
Message Region

The message content contains:

  • Message summary: A short description of the error taken from the Message Text component. The format is: <Error message text.> <(Error Code)>
  • Message user or admin detail: Optional additional details intended for end users or administrative users.
  • Message cause: Optional cause of the error message.
  • Message user action or admin action: Optional action required to be taken by end users or administrative users to resolve the message.
NA
Dialog Box Buttons

Close icon button: Clicking this icon closes the dialog box.

OK button: Clicking this button closes the dialog box.

NA
ADF Component af:messages NA

Cause and Action Variant Message

Where cause and action components are specified, the words Cause and Action are automatically provided. Because these messages can be long, it's best to place them in page-level dialog boxes.

Cause and Action Page-level Error Message Dialog
Figure 7. Cause and Action page-level error message dialog box

Application Error Message

This modal message dialog box appears when an error in the software (not caused by users) occurs. An incident number is automatically generated, along with information indicating that the help desk has been informed. No explicit detail into the cause of the error and action to fix it is provided (as with other errors) because the cause of the error and any resolution is outside the user's control.

Dialog boxes are used because of the serious nature of these errors. If there is a technical constraint on the use of the dialog box, then it is permissible to use an inline message instead. Application error messages are known as critical error messages in the Messaging Usage Guideline.

Application Error Message Dialog with Incident Text
Figure 8. Application error message dialog box with incident text

Components Required

Required Screen Elements for Application Errors
Component Type Required Components Customizable or Extendable Components
Dialog Box Icon Button

Error Qualifier

error_qualifier.png The error icon button precedes the dialog box title. NA
Dialog Box Title Use this wording: Error  
Dialog Box Region

The message content contains:

  • Message summary: A short description of the error taken from the Message Text component. Use this format: <Error message text.> <(Error Code)>
  • Incident creation text: Automatically created and appended with environment details.
NA
Dialog Box Buttons

Close icon button: Clicking this icon button closes the dialog box.

OK: Clicking this button closes the dialog box.

NA
ADF Component af:messages NA
 
Display Options for Error Messages
Return to Top
 

Error

Warning

Information

Processing

Confirmation

Component

Yes
Yes (without a question)
Yes
No
No
List
Yes
Yes (without a question)
Yes
No
No
Page
Yes
Yes
Yes
Yes
Yes
 
Design Considerations
Return to Top
  • Follow Applications Process Model (APM) collaborative design and implementation process for messages. Messages designed outside this process are not supported by Oracle Fusion Applications User Experience.
  • See the Oracle Fusion Message Usage Guideline for guidance about when to use dialog boxes or inline messages and about validation across different components.
Related Guidelines
Return to Top
Messaging Usage Guideline Guidelines for messages usage based on the Rich Client User Experience (RCUX) designs
Oracle Fusion Message Usage Guideline Guideline about validation across different components in the Oracle Fusion Application's UI that explains when to use dialog boxes or inline messages
Secondary Windows Guideline Guidelines for the secondary window component
 
About Oracle | Legal Notices | Terms of Use | Your Privacy Rights