AddTraceProperty()

Adds a stock tracing property assignment to a stock record.

Syntax

AddTraceProperty(<nNumber>, [<cStockID>]) --> nResult

Arguments

<nNumber> --> The ID/number of the stock tracing property to add to the stock record. The numbered list of stock tracing properties is found on the Specification Table under INSTALLATION Workshop, Stock Tracing|Specification Table. For example, 1 = serial numbers, 2 = batch numbers, etc.

<cStockID> --> The optional Stock ID to assign the stock tracing property to. If not specified, the stock tracing property is assigned to the currently selected stock record.

Returns

Return Value of nResult	Meaning
0	Operation was completed successfully.
-1	The operation failed. (General failure.) An error message will be displayed describing the reason for the failure, such as an invalid parameter passed to the function.
-2	The action was not carried out because the tracing property specified has already been assigned to this stock record.
-3	The stock record could not be located.
-4	The Stock Tracing Component is not installed.

Description

This function adds stock tracing properties to a CAPITAL stock record. The function assumes that the STOCK database is open and available. If it is not, use the OpenTable() function to open it first. For more information on stock tracing properties consult the topic Stock Tracing Concepts found in the CAPITAL Series 7 on-line help reference.

The Unique Stock Tracing Component must be installed for this function to have any effect.

____________________________