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.
- @ is required unless fieldname value is used. It means to copy the current row in a loop.
- fieldname is required unless @ is used and can be any fieldname in the DocItem or DocItemTask table. The table name is not required.
- value is required if fieldname is used 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.”
ATC: QUERY qParties ATC: FOREACH qParties BY Specification WITH true; ATC: ADD ITEM @ ATC: SET TargetRow.Note = Auto-added ATC: ENDLOOP
The above example means “run the qParties query (set up separately in the QueryConfig rule) to get a list of items. For each row, add an item to the document’s and set fields based on matching names, then set a note to the attendee row that it was auto-added.” Note: The query in this example was constructed to return field names such as Specification, Description, AccountCategory, etc.
Last updated: January 21, 2026 at 8:50 am; green text = new