Skip to main content

Copy Folder

UiPath.Box.Activities.Folder.CopyFolder

The Copy Folder activity uses the Box Copy folder API to copy a specified folder (Folder Id) into a specified parent folder (Parent Folder Id) under the existing or new folder name (New Folder Name).

After copying the file, the activity outputs a BoxFolder object (Box Folder) that includes the properties of the copied file, including the BoxFolder.Id that you can use to identify the file in subsequent activities (e.g., Delete Folder, Rename Folder, etc.).

How it works​

The following steps and message sequence diagram is an example of how the activity works from design time (i.e., the activity dependencies and input/output properties) to run time.

  1. Complete the Setup steps.
  2. Add the Box Scope activity to your project.
  3. Add an activity or run an external process that outputs a Folder.Id value (e.g., Create Folder, Search for Content, etc.).
  4. Add the Copy Folder activity inside the Box Scope activity.
  5. Enter values for the Input properties.
  6. Create and enter a BoxFolder variable for the Output property.

    • Your input property values are sent in the Copy folder API operation request.

    • The operation returns the BoxFolder value to your output property variable.

      docs image

Properties​

Common​

  • ContinueOnError - Specifies if you want the activity to continue running when an error is thrown. This field supports only Boolean values.
  • DisplayName - The display name of the activity. This field supports only Strings or String variables.

Input​

  • Folder ID - The ID of the folder that you want to copy. This field supports only Strings or String variables. To get the Folder ID value, add an activity or run an external process that outputs a Folder.Id object (e.g., Create Folder, Search for Content, etc.).
  • Parent Folder ID - The ID of the parent folder where you want to copy the file. This field supports only Strings or String variables.
    • Enter a value of "0" to use the root folder of the application.
    • To get the ID of a folder that is not the root, use the Search for Content activity.

Misc​

  • Private - If selected, the values of variables and arguments are no longer logged at Verbose level.

Options​

  • New Folder Name - The name that you want to apply to the folder. This field supports only Strings or String variables. If this property is left empty, the existing folder name is applied.

Output​

  • Box Folder - The BoxFolder object that includes the folder properties. This field supports only BoxFolder variables. The BoxFolder object includes multiple properties that you can use in other activities.