The Dropbox Get File Metadata action is used to retrieve detailed metadata for a file stored in Dropbox. This action allows you to obtain important properties such as the file name, size, creation and modification dates, and path information. It is particularly useful in file management, reporting, and control scenarios.
Technical Specifications
File Metadata Retrieval Process (Metadata Panel): This action retrieves the metadata of the file specified by the path parameter and returns a Dropbox_FileMetadataResult object.
Parameters:
settings (Object – required): These are the settings required for Dropbox API integration. The Dropbox settings defined in the Configuration Manager should be selected here.
path (String – required): The full path of the file whose metadata will be retrieved. (e.g., /Reports/2025/Q1_Report.pdf)
Data Source Compatibility: Parameters can be entered as fixed values or linked from dynamic sources such as Form Input, Action Result, Current, Method Input via the Symbol Picker.
Web & Mobile Support: The Dropbox Get File Metadata action can be used in both web and mobile applications.
Dropbox Get File Metadata Application Steps
1. Action Definition in UI Design
Open your Kuika project.
UI Design module, select the screen from which the metadata information will be retrieved.
Add a Button element (e.g., “Get File Information”).
Click on the button and select the + ADD ACTION → Dropbox → Dropbox Get File Metadata action.
2. Configuring Parameters
settings: Select the Dropbox API setting you created in Configuration Manager.
path: Enter the file path selected by the user or defined as fixed (e.g., /Invoices/2025/January.pdf).
Use Case: Displaying File Information
In a document management application, the user wants to see detailed information about the file they select from a list.
Steps:
Add a list or input that allows file selection.
Connect the “Show Information” button to the OnClick → Dropbox Get File Metadata action.
Connect the path parameter to the file selected by the user.
Display the returned metadata information on the screen using the Label and Table elements.
Dropbox Get File Metadata Advanced Customizations
Conditional Action: If the file has been updated in the last 24 hours, you can show a warning to the user.
Dynamic Controls: You can offer download/preview options based on file size.
Using the Result: The retrieved metadata can be used for another action (e.g., Set Value, Save to Database).
Version Control: You can track file versions by checking the modification date.
Technical Risks and Controls
The path must not be empty. Otherwise, the operation will fail.
Invalid path: If the file 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.
Authorization Restrictions: If user permissions are insufficient, metadata may not be retrieved.
