Groups GeneXus code that's executed sequentially up to the last line, unless there is an error that interrupts it.
Event 'ClientEventName' | Control.AssociatedControlEvent
Is the user event name.
Is the control name that you program the event AssociatedControlEvent
Is one of the events associated with controls (such as tap, long tap, drag, drop, PageChanged, ControlValueChanged, etc. -depending on the control type-)
It details the code to be executed when the event occurs. At least two commands are needed.
The code block Composite/EndComposite groups GeneXus code. This code is executed sequentially to the last line, except when an error in any of such lines occurs. In this case, the sequence will be interrupted.
Therefore, its two main premises are:
- If one of the instructions (calls or assignments) fails, the rest are not executed.
- Error messages (automatic ones as well as loaded by the developer) are displayed on the device screen.
The use of this command is not a must when two or more invocations are performed on an event. Instead, error handling can be done through the &Err and &ErrMsg variables.
The &Err variable takes on a value greater than 0 when an error occurs, while it is set to 0 if the operation runs smoothly.
The possible values of &Err are used to identify the nature of the error:
- 1 for a generic error,
- 2 if the user cancels the action,
- 3 for incorrect parameters.
When an event invokes a GeneXus object located on the server side, such as a Procedure object or a Data Provider object, the value of &Err will reflect the HTTP code returned by that call in case of error. For example, HTTP 404 or 500.
In situations where no response is received from the server (no HTTP code), &Err will be set to 1.
The &ErrMsg variable contains the description of the error that would be displayed on screen if it were inside a Composite block.
It is important to note that in the case without Composite, an error message is not automatically displayed to the end user, and it is your responsibility to manage how these errors are handled and communicated to the end user.
Interop.SendMessage("Your Email has been updated successfully in my database", ClientMobilePhone)
If &Err <> 0
Interop.SendMessage ("Your Email has been updated successfully in my database", ClientMobilePhone)
Grammar of Events on the Client Side and Composite Command
Events in Mobile Applications