AfterComplete Triggering event

Official Content
This documentation is valid for:

AfterComplete is used to trigger a rule after processing all Transaction data; that is, the first level and all subordinated levels. It can be used in environments with or without Transactional Integrity control.

In environments with Transactional Integrity Control, the rules conditioned by an AfterComplete event are triggered after the LUW (Logical Unit of Work) is completed.

In GeneXus, the structure of a Transaction establishes the scope of the LUW. This one is defined as the data entry of the first level and subordinated levels. The Confirm Transactions property, allows the inclusion of a request for confirmation of the LUW. A Commit is performed in case of an affirmative answer. Otherwise, a Rollback is performed, eliminating the operations performed on the database within the LUW. The events conditioned by the AfterComplete event are executed, only if the LUW is confirmed.

In environments without Transactional Integrity, this function is equivalent to other Triggering Events. For example, in a single level Transaction, it is equivalent to: AfterInsert, AfterUpdate, AfterDelete. In case of a multi-level Transaction, it is equivalent to: AfterLevel of the last level of the Transaction (that is: just before it starts the first level of a new LUW).

Syntax

Any valid Transaction rule  [ IF condition ][ ON AfterComplete];

Where:

condition
          Is any valid logic condition

Example

To call a report for print after entering an invoice, if the environment supports Transactional Integrity control, we would want to print the invoice after ensuring the LWU is complete.

Invoice Transaction

InvoiceId*
CustomerId
  (ProductId*
   InvoiceLineQuantity
   . . . 
   InvoiceLineAmount)
InvoiceAmount
PrintInvoice.Call(InvoiceId) On AfterComplete;

Note

In the iSeries and web interfaces, the rule will always be executed after validating the whole transaction.

Scope

Objects: Transaction object

Purpose

To indicate the completion of a Logical Work Unit.

Compatibility

The After(TRN) function is maintained for backward compatibility reasons. We highly recommend using the AfterComplete event instead. For further information see Triggering Events.

See Also

After function
After Trn Event
Transaction rules
Triggering events for rules in transactions


Was this page helpful?
What Is This?
Your feedback about this content is important. Let us know what you think.