Skip to main content

Task PDF - Add Attachment​

The PDF - Add attachment(s) Task attaches one or more files to each PDF file that the File filter selects.

Add attachment(s) Task with the File Filter tab open, showing the Credentials, Folder, Exclude folder(s) and Include file mask settings

The Main settings, Flow, On error, Conditions and TimeOut tabs are the same for every Task; see Job - Tasks.

File Filter tab​

The File Filter tab selects the PDF files to attach files to; see File Filter. If the filter has a Credential, the Task uses it while it reads and writes the files. When the logon with the Credential fails, the Task continues as the account that runs the Server and writes the error to the Server log.

Attachment files tab​

Attachment files tab with its Add, Edit, Clone, Delete and Order toolbar, and the File filter window open over it

The Attachment files tab lists one or more File filters that select the files to attach. Use Add, Edit, Clone and Delete on the toolbar to manage the list, and Order to set the position of the selected item. Every file that a filter matches is attached to every PDF file.

Destination tab​

Destination tab with the Save to.. group, the Folder and File mask boxes, and the Password for input file(s) and Attachment description boxes

  • Same file (Save to.. group): saves the PDF file over the source file

  • Same folder but use file mask: saves the PDF file in the folder set on the File Filter tab, named by File mask

  • Different folder and use file mask: saves the PDF file in Folder, named by File mask

  • Folder: the destination folder for Different folder and use file mask; click the folder button to browse

  • File mask: builds the new file name from the source file name, by the renaming standard set in Main - Settings

    The default * keeps the source file name.

warning

Same file replaces the source file. With the default File mask *, Same folder but use file mask also replaces a source file that is in the File Filter folder. A file that already has the new name is replaced without a prompt.

When Include sub folders is checked on the File Filter, Same folder but use file mask saves every result in the File Filter folder, not in the subfolder the source file came from.

  • Password for input file(s): the password that opens the source PDF files, if they are protected

  • Attachment description: the description stored with each attached file

    Variables are supported.

Output and errors​

The Task output lists the path of each PDF file it saves. When the attachment filters match no file, the PDF file is saved without new attachments.

warning

When the Attachment files tab has no item, the Task writes "No attachments were found" to standard error and saves nothing, and the Task reports success. To fail the Task in this case, set an On error condition on standard error; see Task - On Error.