There are 2 basic types: Messages and Questions.
The difference is that Messages are just displayed in the UI, and after they are displayed (and confirmed in case of a modal message) the UI does nothing. Questions instead require an action/answer from the User. Hence, when displayed in the UI they provide additional buttons like yes/no, which the user can select from. After selecting a button, the backend call is immediately re-performed, providing information to the backend about which button has been clicked. It is then the task of the Backend-code to check for the answered questions and perform the correct logic.
The Message-functionality is available in Business-Tasks (when invoking BT-Methods) and Business-Entities (when submitting Records for create, update, delete).
Backend implementation:
In the Backend, Messages can be created using the message-API:
- Message API / methods
Typical methods that contain code for creating ui-messages:
- Validate
Overview
| Type | Sub-types | Transaction behaviour | UI behaviour | Visualisation Modal/Non-Modal | Sample backend code |
|---|---|---|---|---|---|
| Question | Info / warning / error (?) | Cancel | Show question, after user clicks button, re-perform backend call, unless user pressed cancel | M | |
| (Messages) | |||||
| Information | Info / warning | Commit | Show message | M(?) / N | |
| Message | Info / warning / error | Cancel | Show error message | M / N |