Concatenate Files Action

Declaration

<AMCONCATENATEFILE FILEA="Text" FILEB="Text" CONCATENATEDFILE="Text" OVERWRITEFILE="Text" />

See Also

Concatenate Files Action-Setting Properties

Description

Concatenates two files and outputs the result to a third file.   

Practical Usage

Used to easily

Parameters

General Tab

File A

Text, Required
MARKUP: FILEA="C:\Folder\FileName1.txt"

Specifies the path and file name for the first file.  

File B

Text, Required
MARKUP: FILEB="C:\Folder\FileName2.txt

Specifies the path and file name for the second file.

Concatenated File

Text, Required
MARKUP: CONCATENATEDFILE="C:\FolderName\NewConcatenatedFile"

Specifies the path and file name for the concatenated file.

Overwrite if File Exists

Yes/No, Optional - Default "No"
MARKUP: OVERWRITEFILE="YES"

Specifies whether or not to overwrite if file already exists.

Notes

Custom Description

This action includes the Description tab for entering a custom step description.

More on setting custom step description

Standard Error Handling Options

This action also includes the standard Error Causes and On Error failure handling options/tabs.

More on Error Handling Options

Variables and Expressions

All text fields allow the use of expressions, which can be entered by surrounding the expression in percentage signs (example: %MYVARIABLE%, %Left('Text',2)%). To help construct these expressions, you can open Expression Builder from these fields by pressing F2.

More on variables
More on expressions

More on the expression builder

Example

NOTE: The code below can be copied and pasted directly into the Steps pane of the Task Builder.

<AMCONCATENATEFILE FILEA="C:\FolderA\FileName1.DOC" FILEB="C:\FolderB\FileName2.doc" CONCATENATEDFILE="C:\FolderC\NewConcatenatedFile" OVERWRITEFILE="YES" />