# tBoxCopy (deprecated)

Availability-note[Deprecated](https://help.talend.com/r/en-US/Cloud/labels-on-talend-help-center/availability-deprecated)

This content is deprecated.

Copies or moves a given folder or file from Box.

## tBoxCopy Standard properties

Information noteDeprecation: This component is deprecated since Talend Studio 8.0 R2025-11 and removed from Talend Studio 8.0 R2026-09 onwards. Talend recommends you to migrate your Jobs to use the Box v2 components.

These properties are used to configure tBoxCopy running in the Standard Job framework.

The Standard tBoxCopy component belongs to the Cloud family.

The component in this framework is available in all Talend products.

## Basic settings

| Properties | Description |
| --- | --- |
| Use existing connection | Select this check box and in the Component<br>List drop-down list, select the desired connection component to<br>reuse the connection details you already defined. |
| Connection/Client Key | Enter the client key required by Box to access the Box API. To obtain the client key and<br>client secret you need to create an account at https://developers.box.com/ and then create a Box App under the Box account to<br>be used. The client key and client secret can be obtained from the account application<br>settings. |
| Connection/Client Secret | Enter the client secret required by Box to access the Box API. To obtain the client key and<br>client secret you need to create an account at https://developers.box.com/ and then create a Box App under the Box account to<br>be used. The client key and client secret can be obtained from the account application<br>settings. |
| Connection/Access Token | Enter the access token required by Box to access a Box account and operate it. For how to get<br>the access token and refresh token, check the Box documentation you can access from https://developers.box.com/. |
| Connection/Refresh Token | Enter the refresh token required by Box to refresh the access token automatically. For how to<br>get the access token and refresh token, check the Box documentation you can access from<br>https://developers.box.com/. |
| Connection/Use HTTP proxy | If you are using a proxy, select this check box and enter the host and port information of<br>that proxy in the corresponding fields that are displayed. |
| Move Directory | Select this check box to move a directory in Box. |
| Copy Directory | Select this check box to copy a directory in Box. |
| File Name | Enter file name with the path in Box you want to copy. |
| Source Directory | This option appears when the Move<br>Directory or Copy<br>Directory check box is selected. Enter the source<br>directory in Box to be moved or copied. |
| Destination Directory | Enter the destination directory in Box where the specified file or directory will be<br>copied or moved. |
| Rename | Select this check box to rename the file or directory to be<br>copied. When copying a file, specify the new file name in the<br>Destination File Name field. When copying a<br>directory, enter the new directory name in the New Directory<br>Name field. |
| Remove Source File | Select this check box to remove the source file during the copy<br>action. |
| Schema and Edit schema | A schema is a row description. It defines the number of fields<br>(columns) to be processed and passed on to the next component. When you create a Spark<br>Job, avoid the reserved word line when naming the<br>fields.<br><br>Note that the schema of this component is read-only with four columns named destinationFilePath, destinationFileName, sourceDirectory, and destinationDirectory. |

## Advanced settings

| Properties | Description |
| --- | --- |
| tStatCatcher Statistics | Select this check box to collect log data at the component<br>level. |

## Global Variables

| Variables | Description |
| --- | --- |
| Global Variables | ERROR\_MESSAGE: the error message generated by the<br>component when an error occurs. This is an After variable and it returns a string. This<br>variable functions only if the Die on error checkbox is<br>cleared, if the component has this checkbox.<br><br><br>DESTINATION\_FILENAME: the destination file name. This is an After<br>variable and it returns a string.<br><br><br>DESTINATION\_FILEPATH: the destination file path. This<br>is an After variable and it returns a string.<br><br><br>SOURCE\_DIRECTORY: the source directory.<br>This is an After variable and it returns a string.<br><br><br>DESTINATION\_DIRECTORY: the<br>destination directory. This is an After variable and it returns a string.<br><br>A Flow variable functions during the execution of a component<br>while an After variable functions after the execution of the component.<br><br>To fill up a field or expression with a variable, press Ctrl+Space to access the variable list and choose the variable to use from<br>it.<br><br>For more information about variables, see [Using contexts and variables](https://help.qlik.com/talend/r/en-US/8.0/studio-user-guide/contexts-and-variables). |

## Usage

| Usage guidance | Description |
| --- | --- |
| **Usage rule** | This component is usually used standalone in a subJob to copy or move data from<br>Box. |