User Tools

Site Tools


tplextensionprocesstransactionframe.htm
Navigation:  Templates > Guide to all Templates > Extension Templates >====== Process Transaction Frame extension template ====== Previous pageReturn to chapter overviewNext page

This template is available for any Process procedure in the ABC template family. It is used to override the application's default transaction frame support for any RI operations referenced by the primary table of the process procedure.

The following template prompts are provided:

Generate one transaction for each record read

By default, the Process Transaction Frame extension will enclose a transaction frame around the entire process (Starting the transaction process in the OpenReport method, and finishing the transaction process in the CloseReport method). This gives you an “all or none” default option.

Check this box to allow a transaction frame to be applied to each record read. This allows you to create partial updates in the process procedure, in the event that any errors occur on other records processed.

NoteBox.jpg

You can even get a greater control on how many records get “framed” with the inclusion of the Process Transaction Frame Checkpoint code template in the embed point of the TakeRecord method. This checkbox must be on for the frame checkpoint to be generated.

Include Children in the transaction?

The primary table named by the process procedure will always be included in a transaction frame on any update operation. This option allows you to specify if you want to include any children that are related to the primary table (via the dictionary). Select Always if you want to include all child tables in all update operations. Select Never if you want to exclude all related child tables from all database operations on the primary table.

List of tables included in the transaction

This list box allows you to include other tables that are not default child tables specifically related to the process procedure's primary table. An example of this may be a “history” table that periodically gets updated under user control. Pressing the Insert or Properties button displays the following additional prompts:

Table

Enter the label name of a table that you wish to include in the transaction frame, or press the ellipsis to select a table from the subsequent Select Table dialog.

Include Children in the transaction?

The options shown here are described in detail in the similar prompt documented above.

Classes Tab

Provides the standard template class interface. By default the supporting TransactionManager object generated by the template is named Transaction.

tplextensionprocesstransactionframe.htm.txt · Last modified: 2021/04/15 15:57 (external edit)