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

Warning messages tell users about important immediate or future consequences of data, user interface (UI) action, business rule validation, or requested processes.Warning messages also call attention to any intended or impending action on the user's or the application's part that could have potentially destructive or irreversible consequences.

A warning message may also ask users a direct question, asking them to decide between a choice of actions before they can proceed. This question stops the taskflow until the user responds.

Warning messages may be at the component (and therefore list) or page level, shown either as dialog boxes or inline on the page. Inline messages are set using the inline attribute on the Application Development Framework (ADF) af:messages component. If a question is required, the message must be in a dialog box.

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.

Warning message dialog boxes are modal in cases where users must respond to the warning message by choosing an action in response to a question.

 
Pattern Set Decision Table
Return to Top
 

Error

Warning

Information

Processing

Confirmation

Tells users that the data 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 action, 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 action, or the application's progress.

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

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 Warning Message


When users perform a page action, warnings are listed at the top of the page . Components with warnings are outlined with yellow 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 Messages (Error and Warning Messages, in Order of Severity)
Figure 1. Inline list showing all messages (error and warning messages, in order of severity)
Component-Level Warning Message
Figure 2. Component-level warning message

Component and List Dialog Box Warning Message

When users perform a page action, warnings are listed in a modeless dialog box. Components with warnings are outlined with yellow borders. Focus is given to each editable field individually at the component level from the listed components. The dialog box also enables the user to navigate to other component-level messages or to return to the list in the dialog box using the All button.

Component-level Warning Message
Figure 3. Component-level warning message

Components Required

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

Warning Qualifier

warning_qualifier.png

The Warning icon button precedes the message title. If there is a mix of message types in the list, then the icon buttons and titles reflect the order of severity. Errors are always listed first. NA
Message Title Use this title: Warning  
Message Region

The message content contains:

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

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

  • Component name: A link to the name of the component. Use the component ID to ensure that the name of the link matches the name of the component.
  • Warning qualifier icon button.
  • Message summary: A short description of each warning taken from the Message Text component. Use this wording: <Warning message text.> <(Error Code)> (The error code is optional depending on the support requirements for the business rule.)
  • Message user or admin detail: Optional additional details intended for end users or administrative users.
  • Message cause: Optional cause of the warning 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 button closes the dialog box.

OK: Clicking this button closes the dialog box.

NA
ADF Component af:messages NA

Required Screen Elements for Component Warnings
Component Type Required Components Customizable or Extendable Components
Note Icon Button

Warning Qualifier

warning_qualifier.png

The Warning icon button precedes the note title. NA
Note Title Use this title: Warning  
Note Region

The message content contains:

  • Message summary: A short description of each warning taken from the Message Text component. Use this format and wording: <Warning message text.> <(Error Code)> (The error code is optional depending on the support requirements for the business rule.)
  • Message user or admin detail: Optional additional details intended for end users or administrative users.
  • Message cause: Optional cause of the warning 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 appear if more than one component message is active.  
ADF Component af:message NA

Page-Level Warning Message

Warnings may appear at the page level, either in a dialog box or inline on the page.

This page-level warning appears when a payment batch is created, informing users which invoice terms will be used for the process.

Page-level Inline Warning Message
Figure 4. Page-level inline warning message

This dialog box-based warning message informs users about how a budget adjustment will be calculated for a project.

Page-level Warning Message Dialog
Figure 5. Page-level warning message dialog box

Components Required

Required Screen Elements for Page-level Warnings
Component Type Required Components Customizable or Extendable Components
Note Icon Button

Warning Qualifier

warning_qualifier.png

The warning icon button precedes the note title. NA
Note Title Use this title: Warning NA
Note Region

The message content contains:

  • Message summary: A short description of each warning taken from the Message Text component. Use this format and wording: <Warning message text.> <(Error Code)> (The error code is optional depending on the support requirements for the business rule.)
  • Message user or admin detail: Optional additional details intended for end users or administrative users.
  • Message cause: Optional cause of the warning 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 appear if more than one component message is active. NA
ADF Component af:message NA

Page-Level Warning Message with Decision Point

Warning messages may offer users a decision point in the form of a question that is part of the message. Questions are asked using a page-level dialog box only; questions are not supported at the component or list level. Users must choose between options in the dialog box, presented as action buttons. See the Buttons Usage Guidelines for more information. These dialog boxes are modal, preventing the user from continuing or interacting with the base page without responding to the message dialog box first.

Important: ApplCore and ADF provide modal dialog box warning messages for unsaved data. Product teams should use these. If a team must design their own unsaved data message dialog box, then refer to the details in the Save Model Guideline.

This page-level dialog box tells users that an action cannot be reversed before giving them the option of choosing between actions.

Page-level Warning Message Dialog with Decision Point and Action Buttons
Figure 6. Page-level warning message dialog box with decision point and action buttons
Page-level Warning Message Dialog with Decision Point and Yes and No Buttons
Figure 7. Page-level warning message dialog box with decision point and Yes and No buttons
Required Screen Elements for Page-level Warnings with Decision Point
Component Type Required Components Customizable or Extendable Components
Dialog Box Icon Button

Warning Qualifier

warning_qualifier.png

The warning icon button precedes the dialog box title. NA
Dialog Box Title Use this title: Warning NA
Note Region

The message content contains:

  • Message summary: A short description of each warning taken from the Message Text component. Use this format and wording: <Warning message text.> <(Error Code)> (The error code is optional depending on the support requirements for the business rule.)
  • Message user or admin detail: Optional additional details intended for end users or administrative users.
  • Message cause: Optional cause of the warning 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 button closes the dialog box.

Action buttons.

Yes. Teams can add action buttons in response to questions. Teams may define access keys on these action buttons.
ADF Component af:messages NA
 
Display Options For Warning 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 the 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.

 
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 user interface that explains when to use dialog boxes or inline messages
Secondary Windows Guideline Guidelines for the secondary window component
Buttons Usage Guideline Guideline on buttons used for navigation and actions
Save Model Guideline Guideline for designing save model interactions, including warning messages about unsaved data.
 
About Oracle | Legal Notices | Terms of Use | Your Privacy Rights