5.20.4. List Files

<< Click to Display Table of Contents >>

Navigation:  5. Detailed description of the Actions > 5.20. System Tools >

5.20.4. List Files

 

Icon: ANATEL~4_img266

 

Property window:

 

ANATEL~4_img265

 

Short description:

Returns a list of files from a

directory and its subdirectories.

 

Long Description:

The ANATEL~4_img267 ListFile action does reads a directory tree and returns file names and locations. This is often used in conjunction with the FileOpen functionalities, as input pin. It generates a table with the following columns:

 

Column Name

Content

filePath

Full file path with file name

fileName

file name and extension only

created

creation date

modified

last motification date

lastAccessed

last access date

absolutePath

full path, without the file name

isHidden

hidden attribute, 1/0

isReadable

Read Only Attribute, 0/1

isWritable

Write Protected Attribute, 0/1

isExecutable

Executable attribute. 1/0

size

Size of the file

 

 

The parameters are as follows:
 

File filter: set the filter based on the file name or extension. For example, *2017*.* will return all the files containing 2017 in the name. This is an easy way to open files stored with dates in the name.
 

Directory to list:  set the root directory to analize.
 

Output: set the sort criteria to return the file names:
 

oAll files sorted by name

oAll files sorted by time

oAll files sorted by size

oFirst file (by name, by time, or by Size)

oLast file (by name, by time or by size)
 

Date-time format: set the time format to return in the columns: created, Modified, and Last Accessed
 

Get File Size: a Boolean parameter to specify whether to return the file size in the table
 

Recurse in (sub)directories: Boolean parameter to specify whether to browse sub directories, or only return information from the selected root directory.
 

If no files are found:
 

oReturn an empty table: this is the default option. No error flag is generated

oAbort anatella process with a warning: an warning is generated, but process can still run.

oAbort anatella process with an error: the node turns red, and all is aborted.