Overview

This node operation lists the contents of a specified folder on a Samba (SMB2) server. It connects to the SMB server, reads the directory contents of the given folder path, and outputs the details of each item found in the folder. This operation is useful for scenarios where you need to retrieve and display the files and subfolders within a network-shared folder, such as for file management, monitoring, or integration workflows.

Use Case Examples

1. Listing files in a shared public folder to display them in a dashboard.
2. Retrieving folder contents to trigger further processing on each file.

Properties

Output

JSON

• type - Type of the item, 'd' for directory and 'l' for file/link.
• name - The base name of the file or folder.
• path - The full path of the file or folder on the SMB server.
• attributes - File attributes metadata.
• createTime - Creation time of the file or folder, if available.
• accessTime - Last access time of the file or folder, if available.
• modifyTime - Last modification time of the file or folder, if available.
• changeTime - Change time of the file or folder, if available.
• size - Size of the file in bytes.

Dependencies

• Requires connection to an SMB2 server using appropriate credentials.

Troubleshooting

• Common issues include connection failures due to incorrect SMB server credentials or network issues.
• Errors may occur if the specified folder path does not exist or the user lacks permissions to read the folder.
• If the node throws errors about file attributes or times, it may be due to unsupported SMB server features or file system limitations.

Links

• Server Message Block (SMB) Protocol - General information about the SMB protocol used for file sharing.