table.POST Function

Syntax

V Post()

Description

Specify the required values in the Post dot variable, then use the following command:

Variable
Type and Description
Post.t_db

Type "C". The filename of the secondary, Transaction table.

Post.m_key

Type "C". Contains expression strings that describe how fields or combinations of fields form the linking key in the primary, master table.

Post.t_key

Type "C". Contains expression strings that describe how fields or combinations of fields form the linking key in the secondary, transaction table.

Post.m_filter

Type "L". Optional. Default = .T. (All records). A character filter expression that specifies the records in the Master table that can be changed during the Post operation.

Post.t_filter

Type "L". Optional. Default = .T. (All records). A character filter expression that specifies which records from the secondary, transaction table will be posted. Only the subset of records that pass through the Post.t_filter are filter are used when searching for existing records.

Post.m_count

Type "N". Indicates how many fields are being mapped for the Post operation.

Post.m_field1 ... Post.m_fieldN

Type "C". N fields (1 ... N) that specify the names of the fields in the primary, master table, which is the target of the Post operation.

Post.m_exp1 ... Post.m_expN

N fields (1 ... N) that contain the value, field, or expression used to add, subtract, or replace values in the Master table. You must prefix the transaction table name with @ in expressions (e.g., @inv_items -> quantity ). The following table shows examples of how to form the expression for Replace, Add and Subtract posting operations:

Master Field and Transaction Field
Operation and Expression
On_hand, Inv_items->Qty

Replace, @inv_items -> qty

On_hand, Inv_items->Qty

Add, On_hand + @inv_items -> qty

On_hand, Inv_items->Qty

Subtract, [email protected]_items -> qty

Post.t_count

Type "N". Updating the secondary, transaction table lets you change records used during the Post operation. as in the master mapping, each Transaction mapping is expressed through a group of parameters. post.t_count indicates how many fields are being mapped for the Post operation.

Post.t_case1 ... Post.t_caseN

Type "C". N fields (1 ... N) that specify the conditions under which the Transaction table will be updated. The following values are allowed.

"Posted" = Records that successfully posted a value(s)
"No-match" = Records that do not match any Master records
"Violated" = Records that failed during the operation
Post.t_field1 ... Post.t_fieldN

Type "C". N fields (1 ... N) that specify the name of the secondary, transaction Field to be updated

Post.t_exp1 ... Post.t_expN

Type "A". N fields (1 ... N) that contains a value, field, or expression assigned to the secondary, transaction field. You must prefix the transaction table name with @ in expressions (e.g., @inv_items -> quantity ).

Description 

Replace, add, or subtract fields values in the table using fields from a transaction database.

Discussion 

The <TBL>.POST() method is a high-level utility used to replace, add, or subtract field values in the Master table using field values from a Transaction table.

Example 

This script subtracts values from a transaction table ( Inv_item ) to the inventory table ( Product ). Only records not previously posted are posted (i.e. records for which POSTED = .f.).

dim tbl as P
tbl = table.open("c:\a5\a_sports\product.dbf")
post.t_db = "c:\a5\a_sports\inv_item"
post.m_key = "PROD_NO"
post.t_key = "PROD_NO"
post.m_filter = ""
post.t_filter = ".not. POSTED"
post.m_count = 1
post.m_field1 = "QTY_ON_HAND"
post.m_exp1 = "QTY_ON_HAND - @INV_ITEM->QTY"
post.t_count = 0
tbl.post()
ui_msg_box("Note To User","Operation Complete")

See Also