ATC: ATTACH DUPLICATE [full filename] 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] is required. It specifies the full catalog path and filename for the file. The square brackets are required.  If you specify a $variable, the variable can contain either the path and name, or it can specify the attachment key
  • 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: August 1, 2023 at 8:28 am  

Related Post

ATC: ATTACH ASSEMBLEATC: ATTACH ASSEMBLE

ATC: ATTACH ASSEMBLE options  This command assembles all attachments that are flagged as Incl=Assemble (on the document’s Attachment tab) and attaches that assembled PDF file to the target document. options are optional.  There are several

ATC: ROUTEATC: ROUTE

ATC: ROUTE routelist; option This command alters the route of the current document. routelist is required. It specifies the routing to be applied to the document. The routelist can contain

ATC: SETHTMLATC: SETHTML

ATC: SETHTML tablename.fieldname = new-value This command is similar to the ATC: SET command but maintains any HTML formatting of the text value expressed in the command. The text editor