Business Rules Class Methods

The VPMDataHandlerBusinessRules class is a non-visual custom class that contains methods into which you can enter data-related business rules code that is executed during data handling processes that occur when forms are run.

Business Rules Methods

The following table lists and describes the Business Rules class methods available to you. Study the methods to learn where you can use them in your application development.

∑       Function: The Function column groups the methods according to the data handling function to which they belong.

∑       Run Order: Within a Function the methods are listed in the order in which they are run when the Data Handler performs their data handling function.

∑       Comments: The Comments column describes the method and provides suggestions for its use.

Function

Method

Comments

Add Record

PreAdd

Called by the data handler objectís AddRecord method before the addition of a record. If this method returns .F., the addition of the record is cancelled.

Parameters: stcRulesID, stoCallingObject

Add Record

PostAdd

Called by the data handler objectís AddRecord method after a record has been created. If this method returns .F., the addition of the record is rolled back (the new record is removed/deleted).

Parameters: stcRulesID, stoCallingObject

Copy Record

PreCopy

Called by the data handler objectís AddRecord method before the copying of a record. If this method returns .F., the copying of the record is cancelled.

Parameters: stcRulesID, stoCallingObject

Copy Record

PostCopy

Called by the data handler objectís AddRecord method after a record has been copied. If this method returns .F., the copying of the record is rolled back (the copied record is removed/deleted).

Parameters: stcRulesID, stoCallingObject

Delete Record

PreDeletePreTransaction

Called by the data handler objectís DeleteRecord method before the deletion of a record. If this method returns .F., the deletion of the record is cancelled.

Parameters: stcRulesID, stoCallingObject

Delete Record

PreDelete

Called by the data handler objectís DeleteRecord method before the deletion of a record. If this method returns .F., the deletion of the record is cancelled.

Parameters: stcRulesID, stoCallingObject

Delete Record

PostDelete

Called by the data handler objectís DeleteRecord method after the deletion of a record. If this method returns .F., the deletion of the record is rolled back (the deleted record is undeleted).

Parameters: stcRulesID, stoCallingObject

Delete Record

PostDeletePostTransaction

Called by the data handler objectís DeleteRecord method after the deletion of a record.

Parameters: stcRulesID, stoCallingObject

Restore Record

PreRestore

Called by the data handler objectís RestoreRecord method before the restoring of a record. If this method returns .F., the restore is cancelled.

Parameters: stcRulesID, stoCallingObject

Restore Record

PostRestore

Called by the data handler objectís RestoreRecord method after restoring a record.

Parameters: stcRulesID, stoCallingObject

Save Record

PreSavePreTransaction

Called by the data handler objectís SaveRecord method before the saving of a record. If this method returns .F., the save is cancelled.

Parameters: stcRulesID, stoCallingObject

Save Record

PreSave

Called by the data handler objectís SaveRecord method before the saving of a record. If this method returns .F., the save is cancelled.

Parameters: stcRulesID, stoCallingObject

Save Record

PostSave

Called by the data handler objectís SaveRecord method after the saving of a record. If this method returns .F., the saving of the record is rolled back.

Parameters: stcRulesID, stoCallingObject

Save Record

PostSavePostTransaction

Called by the data handler objectís SaveRecord method after the saving of a record.

Parameters: stcRulesID, stoCallingObject

Field Validation

PreFieldValidation

Called by the data handler objectís FieldValidation method before the validation of a field value. If this method returns .F., the code in this method determines what value and message is returned by the FieldValidation method.

Parameters: stcDatabase, stcTableOrView, stcField, stValue, stcRulesID, stoCallingObject

Field Validation

FieldValidation

Called by the data handler objectís FieldValidation method when validating a field value. If this method returns .F., the code in this method determines what value and message is returned by the FieldValidation method.

Parameters: stcDatabase, stcTableOrView, stcField, stValue, stcRulesID, stoCallingObject

Field Validation

PostFieldValidation

Called by the data handler objectís FieldValidation method after validating a field value. If this method returns .F., the code in this method determines what value and message is returned by the FieldValidation method.

Parameters: stcDatabase, stcTableOrView, stcField, stValue, stcRulesID, stoCallingObject

More:

Calling the Business Rules Methods