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 |
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 |
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 |
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 |
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 |