Skip to main content

ListSFTPFile

Description

Lists all blob files under a virtual directory using specified sorting and name pattern options.

info
  • Ensure that you have a properly configured SFTP connection resource set up under the Resources folder.
  • SFTP file names are typically case-sensitive; therefore, abc.JPG, abc.jpg, and ABC.jpg will be saved as different files. To ensure consistency, we recommend using lower-case file names and extensions: abc.jpg.

Configuration

FieldRequiredDescriptionExample
NameRequiredThe name of the activity. This name must be unique in a workflow.List Deployment Error Files
DescriptionOptionalThe description of the activity. We recommend you make this as clear as possible to guide execution, foster understanding, and support collaboration.Lists application error files created in the deployment-errors folder post deployment.
ABS ConnectionRequiredA predefined resource for accessing ABS blobs./Resources/ABSConnection
Container NameRequiredThe name of the container in ABS.hrms-deployment
Blob PathRequired

The location of the virtual directory that contains the blobs that you want to list.

Note

While entering the path, only include the virtual directories without adding the container name, because the container name is already specified (see Container Name, above).

For example, consider the following complete path:

hrms-deployment/deployment-errors/application

In this complete path:

  • hrms-deployment is the blob container.
  • application is the virtual directory that contains the error files that you want listed.
  • deployment-errors/application is the path to the blob.
PatternOptionalThe file pattern that you want to use to filter the list of files in the target virtual directory.*.txt
PrefixOptionalLists blobs whose names begin with the specified prefix.2025-03-31
Max ResultsOptionalSpecifies the maximum number of search results to return at a time.10
RecursiveOptionalInstructs the application to retrieve matching blobs recursively from child folders.Deselected
DescendingOptionalInstructs the application to display results in alphabetically descending order.Deselected

Input

FieldRequiredData TypeDescriptionExample
filepathOptionalStringThe location of the virtual directory (without the container name) that contains the blobs that you want to list.image-processing/temp
patternOptionalStringThe file pattern that you want to use to filter the list of files in the target virtual directory.*.txt
prefixOptionalStringThe prefix that you want to use to identify blobs to be listed from the specified file path.EMP_2025_
maxResultOptionalNumberThe maximum number of search results that you want to be returned at a time.20
recursiveOptionalBooleanInstructs the application to retrieve matching blobs recursively from child folders, if true.FALSE
descendingOptionalBooleanInstructs the application to display results in alphabetically descending order, if true.FALSE

Output

FieldRequiredData TypeDescriptionExample
schemaRequiredNAA custom schema that can be imported.NA
titleRequiredStringTitle of the object containing the data returned.ListFileOutput
pathRequiredStringThe path to the object, without the container name.image-processing/temp
filesRequiredArrayThe list of files returned as a result of the List query.NA
files > pathRequiredStringThe path, without the container name, of the file.image-processing/temp
files > nameRequiredStringName of the fileEMP_2025_00123.png
files > sizeRequiredNumberThe size of the file (in bytes).2500
files > createdTimeRequiredStringThe date-time when the file was created.2025-03-10T19:20:30+01:00
files > lastModifiedRequiredStringThe date-time when the file was last modified.2025-03-15T09:10:30+01:00
files > permissionsRequiredStringPermissions associated with the file.Read, write, delete or manage blobs
files > propertiesRequiredStringProperties associated with the file.blob_type
files > directoryRequiredBooleanIndicates a child directory.True
totalFilesRequiredNumberIndicates the number of files in the target directory.23