Message Object Properties

The following properties of sap.ui.core.message.Message instances are important:

• Target: Describes the part of the application to which the message applies. If the target is empty, the message applies to the entire application. The target format depends on the used message processor. Currently,SAPUI5 supports two types of targets:

  • Control IDs with control properties: The sap.ui.core.message.ControlMessageProcessor propagates these messages to the affected control.

  • Binding path: The sap.ui.model.Model propagates these messages to affected bindings.

• Message processor: The object that handles the message in the application and propagates the message to correct controls, bindings, or other objects, see sap.ui.core.message.ControlMessageProcessor in the API reference.

• Type: Defines the severity of the message; possible types are: error, warning, info, and success, see sap.ui.core.MessageType in the API reference.

• Message text: The actual message text describing the issue. This text is shown to the user.

• Persistent: This property influences the lifecycle of the message. Non-persistent messages are cleaned up by the framework messaging lifecycle, persistent messages have to be removed manually by the application.

Message Creation

There are several ways to create messages automatically and push them into the central message model:

• Validation messages refer to a control. They are created by the SAPUI5 framework when data is parsed, formatted, and validated according to defined data types, see Formatting, Parsing, and Validating Data. Such messages are propagated to one specific control. For more information, see Validation Messages.

• OData V2 messages refer to a binding path. They are typically managed by the server and are changed every time the back end responds to a request. Such messages are propagated to all bindings with the specific binding path. For more information, see OData V2 Messages.

You can also create messages manually or extend the messaging features provided by the framework:

• You can create custom messages manually via the central Messaging APIs, for example Messaging.addMessages(), with Messaging required from the sap/ui/core/Messaging module. For these manually created messages, the application has to ensure a proper message lifecycle.

• For custom target formats, you can use the custom message processor. The own message processor has to inherit from the class sap.ui.core.message.MessageProcessor.

• If the used back end serves messages in a special way, you can use your own implementation of sap.ui.core.message.MessageParser. For more information, see Implementing Your Own OData V2 Message Parser.