The Dropbox List Files action is used to retrieve a list of files and subfolders in the specified folder within Dropbox. This allows your application to display folder contents and offer users dynamic file selection. It is particularly useful in file management, content scanning, selection, or verification scenarios.
Technical Specifications
File Listing Process (List Panel): This action lists the contents of the folder specified by the path parameter and returns a Dropbox_FilesResult object.
Parameters:
settings (Object – required): Settings required for Dropbox API integration. Dropbox settings defined via the Configuration Manager should be selected here.
path (String – required): The full path of the folder where the files will be listed. (e.g., /Reports/2025/)
Data Source Compatibility: Parameters can be entered with fixed values or obtained from dynamic sources such as Form Input, Action Result, Current, Method Input via the Symbol Picker.
Web & Mobile Support: The Dropbox List Files action can be used in both web and mobile applications.
Dropbox List Files Application Steps
1. Defining the Action in UI Design
Open your Kuika project.
In the UI Design module, select the screen where the folder contents will be listed.
Add a Button element (e.g., “List Files”).
Click the button and select the + ADD ACTION → Dropbox → Dropbox List Files action.
2. Configuring Parameters
settings: Select the Dropbox API setting you created in Configuration Manager.
path: Enter the folder path selected by the user or defined as fixed (e.g., /Projects/Design/).
Use Case: Listing the Reports Folder
In a reporting application, when the user clicks the “Show Reports” button, the list of files in the /Reports/2025/ folder is displayed on the screen.
Steps:
Add the “Show Reports” button.
Add the OnClick → Dropbox List Files action.
Set the path parameter to a fixed value such as /Reports/2025/ or link it to user input.
Display the returned results on the screen using a List, Table, or GalleryView element.
Dropbox List Files Advanced Customizations
Dynamic Folder Selection: The user can be prompted to select a folder, and the contents of the selected folder can be listed.
Conditional Display: If the folder is empty, the message “There are no files in this folder” can be displayed.
Using the Results: The listed file paths can be transferred to other actions (e.g., Download File, Delete File).
Integration with Subfolders: Subfolder contents can also be browsed dynamically.
Technical Risks and Controls
The path must not be empty. Otherwise, the operation will fail.
Invalid path: If the specified folder does not exist, an error will be returned.
Settings must be configured correctly. If the Dropbox API setting is not configured in Configuration Manager, the action will not work.
Large Folders: When there are too many files, loading the results may take time, and pagination may be required.
