The Dropbox Copy Item action is used to copy a file or folder from a specified location in your Dropbox account to another location. The original item is preserved and a new copy is created in the destination location. It is particularly useful in backup, versioning, or file organization scenarios.

Technical Specifications

Copy Process (Copy Panel): The Dropbox Copy Item action takes the source file/folder specified by fromPath and copies it to the destination location specified by toPath.

Parameters:

• settings (Object – required): API settings required for Dropbox integration. Dropbox settings defined via Configuration Manager should be selected here.
• fromPath (String – required): The current path of the file or folder to be copied. (e.g., /Documents/report.pdf)
• toPath (String – required): The target path where the copy will be created. (e.g., /Backup/report_copy.pdf)

Data Source Compatibility: Parameters can be entered as fixed values or retrieved from dynamic sources such as Form Input, Action Result, Current, Method Input via the Symbol Picker.

Web & Mobile Support: The Dropbox Copy Item action works seamlessly in both web and mobile applications.

Dropbox Copy Item Application Steps

1. Defining the Action in UI Design

• Open your Kuika project.
• Go to the UI Design module and select the screen where the copying will take place.
• Add a Button element (e.g., “Copy”).
• Click on the button and select the + ADD ACTION → Dropbox→ Dropbox Copy Item action.

2. Configuring Parameters

• settings: Select the Dropbox API setting you defined in Configuration Manager.
• fromPath: Link the file path selected by the user (e.g., /Reports/2025/Q1.pdf).
• toPath: Specify the target path where the copy will be created (e.g., /Backups/Q1_backup.pdf).

Use Case: Backup System

In a file management application, when the user clicks the “Copy Report” button, the report is copied to a different folder within Dropbox.

Steps:

1. Add a Button element to the user interface.
2. Then add the OnClick → Dropbox Copy Item action.
3. Link the fromPath parameter to the file path obtained from the user.
4. Direct the toPath parameter to a fixed “Backup” folder.
5. Once the process is complete, the copied file will appear in the destination folder.

Dropbox Copy Item Advanced Customizations

• Dynamic Backup: Copying can be done to different folders based on user selection.
• Conditional Copying: If the same file exists in the destination folder, a new version can be created without overwriting.
• Use of Results: The result of the copy operation (e.g., destination file path) can be used in another action.
• Automatic Copying: Files can be automatically backed up when a specific task is completed (e.g., report generation).

Technical Risks and Controls

• fromPath and toPath must not be empty. Otherwise, the operation will fail.
• fromPath must contain the correct file/folder path. If an incorrect path is entered, an error will be returned.
• toPath may conflict with an existing file. Overwriting must be checked.
• settings must be configured correctly. If the Dropbox API setting is not configured in Configuration Manager, the action will not work.