Description

Reads data from a file and places the data in a variable.

Declaration

<AMFILEREAD FILE="text" RESULTVARIABLE="text" MAXBYTES="number" BYTESVARIABLE="text">

Example

<AMFILEREAD FILE="C:\foldername\names.txt" RESULTVARIABLE="datafromfile" MAXBYTES="100000" BYTESVARIABLE="amountread">

General Tab Parameters

File: Specifies the file(s) to containing the data that should be read.

Text, Required
MARKUP: FILE="c:\sourcefoldername\file.txt"

Populate variable with read data: Specified the name of the variable to populate with the text contents of the file. The variable must have been created using a Create Variable <AMCREATEVAR> previous step.

Text, Required
MARKUP: RESULTVARIABLE="varname"

Read entire file: Reads in entire file.

Read file partially: Reads in parts of the file as specified in the fields below:

Read from position: Only available when Read file partially is selected. Specify a position in the file from which to start reading.

Populate variable with new position in file: Select the check box, then specify the position.

Text, Required
MARKUP: BYTESVARIABLE="varname"

Limit number of bytes read to: Select the check box then specify the maximum number of bytes that should be read from the text file. This limit is important because it prevents Automated Workflow from taking up a virtually unlimited amount of system memory depending on the size of the file. Text beyond this amount of space is truncated.

number, Optional default - (5120)
MARKUP: MAXBYTES="7777"

Advanced Tab Parameters

Populate variable with number of bytes read: Specify the name of the variable to populate with the number of bytes that were read from the file. The variable must have been created using a Create Variable <AMCREATEVAR> previous step.

Text, Required

MARKUP: BYTESVARIABLE="varname"

See Also

Copy File, Move File, Delete File, Delete Folder, Rename Folder