Compartilhar via


Event list

The following table lists the events available for each extensible object in the Dynamics GP service. You will use this information when planing which events to use for your extension, and when you edit the BusinessObjectFile.config to register the actual events.

Event

Occurs

Typical use

EventHandlerType

Comments

Retrieved

After the object has been retrieved from the database, but before it has been returned from the service.

Retrieve additional data for a service object.

BusinessObjectEventHandler

None

DefaultingForCreate

Before the object has been saved to the database.

Apply defaulting logic for the extended data.

BusinessObjectEventHandler

None

ValidatingForCreate

After the defaulting event, but before the object is saved to the database.

Apply validation rules for the extended data.

BusinessObjectValidateEventHandler

All validation events run, allowing all validation exceptions to be logged. If validation errors have been logged, further processing stops.

Creating

Immediately after the object is created in the database.

Save extended data to the appropriate tables in the database.

BusinessObjectEventHandler

This event is included in the database transaction that creates the base object.

Created

After the object has been created successfully in the database.

None

BusinessObjectEventHandler

None

DefaultingForUpdate

Before the object has been updated in the database.

Apply defaulting logic for the extended data.

BusinessObjectUpdateEvent
Handler

Has access to the original version of the core business object.

ValidatingForUpdate

After the defaulting event, but before the object is updated in the database.

Apply validation rules for the extended data.

BusinessObjectValidateFor
UpdateEventHandler

Has access to the previous version (before update) of the core business object. All validation events run, allowing all validation exceptions to be logged. If validation errors have been logged, further processing stops.

Updating

Immediately after the object is updated in the database.

Update extended data in the appropriate tables in the database.

BusinessObjectUpdateEvent
Handler

Has access to the original version of the core business object.

This event is included in the database transaction that updates the base object.

Updated

After the object has been updated successfully in the database.

None

BusinessObjectUpdateEvent
Handler

Has access to the original version of the core business object.

DefaultingForDelete

Before the object has been deleted from the database.

None

BusinessObjectEventHandler

None

ValidatingForDelete

After the defaulting event, but before the object has been deleted from the database.

Verifies any preconditions required for the object to be deleted.

BusinessObjectValidateEventHandler

All validation events run, allowing all validation exceptions to be logged. If validation errors have been logged, further processing stops.

Deleting

Immediately after the object has been deleted from the database.

Delete extended data from the appropriate tables in the database.

BusinessObjectEventHandler

This event is included in the database transaction that deletes the base object.

Deleted

After the object has been deleted successfully from the database.

None

BusinessObjectEventHandler

None

DefaultingForVoid

Before the object has been voided.

None

BusinessObjectEventHandler

None

ValidatingForVoid

After the defaulting event, but before the object has been voided.

Verifies any preconditions required for the object to be voided.

BusinessObjectValidateEventHandler

All validation events run, allowing all validation exceptions to be logged. If validation errors have been logged, further processing stops.

Voiding

Immediately after the object has been voided.

Performs any necessary "void" action on the extended data.

BusinessObjectEventHandler

None

Voided

After the object has been voided successfully.

None

BusinessObjectEventHandler

None