Add Row

Synopsis

ADDPL/{num list,stringlist[{,INT|,STR}],quantity|obj list}[,IFERR,label:]

Description

Allows you to add a row to the parts list either by entering the values manually or by specifying an existing object which contains assigned attributes.

To add a row to the parts list manually, specify a list of field (or column) numbers corresponding to a list of field values along with a quantity value. For example, a number list of 1 followed by a string list of 'WASHER' specifies that the field value 'WASHER' is to appear in column 1 of the parts list for the added row. Fields that exist in the parts list but have no values specified are blank.

The optional minor words STR and INT indicate that either a string or integer quantity value follows. If neither minor word is specified, you must specify the quantity as a real number.

To add existing objects to the parts list, you must specify the desired objects in an object list. Any attribute values attached to the object that match the attribute titles specified in the parts list format are added to the parts list. If the object has no attributes corresponding to the attribute titles specified in the format, nothing is added to the parts list. If the same object is added multiple times, the quantity on the existing row for that object increments accordingly.

Parameters

Parameter

Description

num list

A list or array of field (column) numbers which correspond to a list of field values in the string list. The list may contain a maximum of 14 column numbers.

string list

A list or array containing the field values for the field numbers specified in the corresponding num list. Field values may be a maximum of 80 characters in length. If each value is entered directly as a string, each must be enclosed by single quotes ('').

INT

Minor word indicating that the quantity value must be an integer.

STR

Minor word indicating that the quantity value must be a string.

quantity

Quantity value whose type corresponds to the preceding minor word (INT or STR). If no minor word is specified, the value must be a real number.

obj list

A list specifying the existing objects you wish to add to the parts list. Field values are based upon attributes currently attached to the object which match attribute titles specified in the parts list format.

IFERR,label:

A label to which program execution jumps if an error occurs.

Parameter	Description
num list	A list or array of field (column) numbers which correspond to a list of field values in the string list. The list may contain a maximum of 14 column numbers.
string list	A list or array containing the field values for the field numbers specified in the corresponding num list. Field values may be a maximum of 80 characters in length. If each value is entered directly as a string, each must be enclosed by single quotes ('').
INT	Minor word indicating that the quantity value must be an integer.
STR	Minor word indicating that the quantity value must be a string.
quantity	Quantity value whose type corresponds to the preceding minor word (INT or STR). If no minor word is specified, the value must be a real number.
obj list	A list specifying the existing objects you wish to add to the parts list. Field values are based upon attributes currently attached to the object which match attribute titles specified in the parts list format.
IFERR,label:	A label to which program execution jumps if an error occurs.