Define banner display persistence
Define if a message or banner displayed on a mobile device requires the user to acknowledge the receipt of the message.
Before you begin
Role required: admin
About this task
Configure specific messages to remain on a screen until the user actively dismisses the message. By default, messages fade after a few seconds.
When a function button has multiple messages associated to it, then all associated messages are consolidated into a single message. If one of these messages contains a persistence attribute, then the single consolidated message adopts the persistence behavior.
Only one banner message is displayed at a time. Newer banner messages replace existing banner messages. This replacement occurs even if the original existing banner contains persistent attributes.
| Banner display for iOS | Banner display for Android | Banner variants according to message |
|---|---|---|
iOS interface with green positive banner|\[Omitted image "toast-alert-android.png"\] Alt text: Android interface with red negative error|\[Omitted image "toast-alert-variants.png"\] Alt text: Variants listed showing different colors and messages for banner|
Procedure
Navigate to All > System Mobile > Mobile App Builder.
The Mobile App Builder opens in a new browser tab and displays the application scope selection screen.
Search for the application scope you are working in and then select the name of the application scope.
The Mobile App Builder categories home screen displays.
Select Functions from the menu.
Select a function where you want to add the persistence banner behavior.
In the Function record, make sure Action item is selected for the Type field.
Scroll down to the Messages section, and enter text in the Success Message field.
Scroll down to the Button attributes section and select an existing button attribute record or select New to add one.
In the Button Attribute record, complete the following fields as needed to add the persistent behavior attribute.
Field Description Button Name of the button record. This information is automatically populated from the function record. Name The button attribute. Select alerts_require_dismissal. Value Whether the attribute is turned on. Enter trueto turn on the attribute. By default, the Value is set to true.Select Save.
Result
A banner remains on the screen until the user actively dismisses it.