ATC: ADD INCLUSION

ATC: ADD INCLUSION @ | fieldname value | WITH filter;

[V2020+] This command adds one or more items from a document’s Incl/Excl tab to the current target document. No save is required. The new row is available as the TargetRow alias.

  • @ is optional but if specified must be first.  It copies the current row from a FOR EACH loop. Fields in the FOR EACH command are matched by name to the new inclusion/exclusion row.
  • fieldname value is required if neither @ or WITH is specified.   fieldname can be any fieldname in the DocInclusion table. The table name should not be specified. fieldname must be followed by value. value can include $ variables or bookmarks.  Bookmarks must be within square brackets.
  • WITH filter; is optional but requires the ending semicolon(;).  It specifies a filter for limiting the rows to those in the source document that match.  Use .NET Data Expression syntax. (See Example 3.) For more information see the Data Dictionary and .NET data expression syntax.

Examples:

ATC: ADD INCLUSION ItemType E ItemNumber 9 
ATC: SET TargetRow.ItemText = No Pets Allowed

The above example means “add a row in the Incl/Excl tab with type “E” (exclusion) and set the Item Number to 9, then set the text to No Pets Allowed.”

ATC: ADD INCLUSION @
ATC: SET TargetRow.ItemText = No Pets Allowed

The above example means “Copy the current row from the FOR EACH loop, then set the item text to No Pets Allowed.”

ATC: GET KEY $SC WITH SOURCE
ATC: ADD INCLUSIONS WITH ItemType = 'O'

The above example means “Load a document (probably the subcontract)  and copy the type O (other) inclusions.”


Last updated: August 26, 2021 at 9:52 am;  green text = new