Table of contents

Official Content

Displays a message as a notice or warning, but it doesn't prevent you from continuing working. 


Msg('message' | &var | character_expression [,ExceptionName]) [ IF condition ] [ON triggering event];


'message' (or &var or character_expression)
         Is the phrase (string) you want to display when the condition is complied with.
         When using a variable or character_expression, GeneXus controls the resulting type is character (if not, it is adviced in the navigation report).

         If the transaction is configured as Business Component, the ExceptionName parameter can be set as the ID of the message to solve Error handling in Business Components

         Is any valid logic condition

triggering event
         Is one of the predefined events available in GeneXus for transaction rules, which allows you to define the precise time for executing a rule


Objects: Transaction


This rule is used to display a message as a notice or warning, with the possibility to continue working if the condition is complied with. In other words, it does not stop the process as it happens with the Error rule.


Example 1

Customer Rules:

msg('The address is empty') if CustomerAddress.isempty();
msg('The phone is empty') if CustomerPhone.isempty();
error('Enter the customer name please') if CustomerName.isempty();
error('Enter the customer last name please') if CustomerLastName.isempty();

Example 2

Suppose the Customer transaction is set as Business Component and the transaction has the following rule defined:

msg('The phone is empty',CustomerPhoneIsEmpty) if CustomerPhone.isempty();

The value referenced in the ExceptionName parameter will be charged in the &Messages collection variable based on the Messages SDT (in the "ID" property) which you can load using the GetMessages() method.

Example code:

&CustomerBc is a Customer variable

If &CustomerBc.Fail()
   &Messages = &CutomerBc.GetMessages()
    If &Messages.Item(1).ID = CustomerPhoneIsEmpty

The ExceptionName parameter is an identifier, so it does not accept neither spaces, special characters: / : ” | = < > | nor Functions.

If the syntax is not correct, GeneXus will show the following compilation error:

xxx.cs(yy,yy): error CS0103: the name 'pushError' does not exist in the actual context.

See Also

Message command
Transaction rules

Last update: November 2023 | © GeneXus. All rights reserved. GeneXus Powered by Globant