Message Bar

You can use the message bar to display messages.

Prerequisites

To use the message bar, you need to enter parameter INPLACE_MESSAGE_AREA with one of the parameter values available in Customizing for UI Framework under Start of the navigation path Technical Role Definition Next navigation step Define Parameters End of the navigation path .

To use the message bar located in the upper work area, you need to enter parameter value INPLACEWINDOW; to use the message bar located in the work area toolbar, you need to enter parameter value ANCHOR. If you enter no parameter value, the message bar is located in the work area toolbar as default.

To make the message bar available in your business role, you need to assign function profile PARAMETERS to your business role in Customizing for UI Framework under Start of the navigation path Business Roles Next navigation step Define Business Role End of the navigation path .

Features

The message bar is located at the right hand side of the browser window, beside the work area toolbar. You can move the message bar to any part of the browser window below the branding area by using drag and drop. If you click the triangle icon in the upper right corner, you can move the message bar back to its original position.

If the message bar was moved to another place and no new messages are available, it automatically disappears. When new messages are available, the message bar is displayed in its original place.

A message bar header shows the icon of the corresponding message type and the number of messages that are related to this message type. The following message types are available: warnings, alerts, error messages, and information messages.

The triangle icon in the lower left corner indicates that you can open the message bar by clicking it. You can resize the open message list by clicking the dotted triangle icon in the lower left corner. If you click the message bar again or the X in the upper right corner of the message list, the message list is closed. It disappears automatically if no messages are to be displayed anymore.

Preview of New Messages

You can see a preview of new messages above the message bar. If less than five new messages are available, every message appears one after another in a preview above the message bar and disappears again. If more than five new messages are available, a notice indicates that new messages are available.

You can personalize the preview of new messages on the central personalization page by clicking Personalize in the header area of the WebClient UI. For more information, see Central Personalization.

Navigation to Field That Issued a Message

By clicking a link, you can navigate directly from the message to the field that issued the message.

This function is automatically available for the following fields:

Fields that are defined as mandatory in the UI Configuration Tool
Fields that are defined as mandatory in the business object layer (BOL)

For more information, see Mandatory Fields.

For all other cases where messages are related to fields, you can enable the navigation links from the message to the field that issued the message.

Note Note

For this function, you must carry out additional development activities on a project basis.

End of the note.

For information about enabling the navigation links to the fields that issued the message, see Enabling Links in Messages.

Coloring of Field That Issued a Message

You can define the color of input fields and dropdown lists to reflect their status.

Note Note

For this function, you must carry out the following additional development activities on a project basis.

End of the note.

You can do this by using the method SET_FIELD_STATE. Possible values for parameter IV_STATE are W (warning) for yellow coloring and E (error) for red coloring. The field status is reset at every roundtrip. So there is no need to delete the status that is set. If, after revalidation, the status of the field is still problematic, method SET_FIELD_STATE must be called again.