ATC: ATTACH DUPLICATE [full filename] COMMENT text

ATC: ATTACH DUPLICATE $FileKey COMMENT text

ATC: ATTACH DUPLICATE  PROJECT Project FOLDER [full path] NAME [name.ext] COMMENT text

This command attaches a clone of a file already in the Spitfire Catalog to a document being created or modified by the workflow script. [See ATC: ATTACH FILE if the intention is to attach a link to an existing file instead.]

  • [full filename] must begin with an open square bracket.  This legacy version of the command is seldom used because it does not scale well.  
  • $FileKey can be any variable name.  The variable should contain a file key, likely returned from a qAlias (see example)
  • PROJECT when specified must be the first option and must be followed by FOLDER and NAME.  Project  can be a variable or a project ID
  • FOLDER must immediately follow PROJECT and must be followed by NAME.  [full path] must be in brackets and begin with a slash (/).  You can use a $variable.
  • NAME must immediately follow FOLDER   [name.ext] must be in brackets.  You can use a $variable.  Examples would include sample.docx and insuranceCert.pdf.
  • COMMENT text is optional. The text will appear as a note on the Attachment tab.

Examples:

ATC: ATTACH DUPLICATE [/Compliance Forms/W9.pdf]

The above example means “create a cloned copy of the W9.pdf file that is found on the Compliance Forms folder in the Catalog and attach it to the document.”

ATC: QUERY qRelevantFiles
ATC: FOREACH qRelevantFiles BY ReferenceDate
   ATC: SET $FileKey = @.FileKey
   ATC: ATTACH DUPLICATE $FileKey COMMENT relevant file
ATC: ENDLOOP

The above example means “run a query that returns a list of relevant files and for each file returned, set the $FileKey variable to the file key and attach a cloned copy of the file to the document.”  In this simplified example, there is no meaning to what represents a relevant file – it might involve file type, date range and other criteria.  The query should NOT return files already attached to the document.


Last updated: June 27, 2025 at 19:33 pm  

Related Post

ATC: QUERYATC: QUERY

ATC: QUERY qalias d1 d2 d3 This command runs the query dynamically defined through a QueryConfig | qalias:Alias rule. The result set is thus available for other ATC commands in the workflow