ATC: ADD ITEM fieldname value

This command adds an Item to the current document and sets the named fields to the value specified. Multiple fieldname and values can be specified, separated by semicolon.

  • fieldname is required and can be any fieldname in the DocItem or DocItemTask table. The table name is not required.
  • value is required and can include nested bookmarks

Note: after this command, you can use TargetRow to reference the last table mentioned in your ADD ITEM command.

Examples

ATC: ADD ITEM ProjEntity 15000; AccountCategory Labor; Description Mechanical;

The above example means “add an Item with Cost Code 15000 [DocItemTask.ProjEntity], an Account Category of Labor, and a Description of Mechanical

Use ATC: SETHTML for enhanced text in the Description field:

ATC: ADD ITEM ProjEntity 15000; Specification Major Stuff;
ATC: SETHTML TargetRow.Description = Way too cool

The above example means “add an Item with Cost Code 15000 [DocItemTask.ProjEntity] and a Spec [DocItem.Specification] of Major Stuff, then set the Description field [DocItem.Description] to Way too cool, formatted as shown.”


Last updated: October 24, 2018 at 9:29 am; green text = new

Related Post

ATC: STATUSATC: STATUS

ATC: STATUS statuscode This command sets the status code on the current document to the value specified.  This command is the same as ATC: SET STATUS = statuscode is required.

ATC: TARGETATC: TARGET

ATC: TARGET tablename option This command sets the Target table row for subsequent ATC: IF and ATC: SET commands. tablename is required and denotes the table to be used (e.g. DocItem). option

ATC: FOREACHATC: FOREACH

ATC: FOREACH table  state BY sortfield WITH filter; This command begins a block of commands that will repeat once for each row in the specified table (that matches the filter).