Move File
Description
The Move File activity moves an existing file in IB Drive from its current location to a specified target folder.
After the operation completes, the file is available in the target folder and is no longer available at its original location.
Common settings
Use Process Data to bind supported inputs to workflow values or upstream outputs. See Common Activity Features for shared execution, error-handling, and output-persistence settings. Availability depends on the activity.
Design-Time Configuration
Display Text
Specifies a user-defined name for the activity.
The display text appears on the workflow canvas and can be used to identify the purpose of the activity.
File
Specifies the IB Drive file to be moved.
The file can be specified using one of the following methods:
| Method | Description |
|---|---|
| Select File | Select the file by browsing IB Drive using the file picker. |
| By Id | Specify the unique IB Drive item ID of the file. This is the default method. |
| By Path | Specify the logical path of the file within IB Drive, for example /Agents/InvoiceProcessing/Input/Invoice.pdf. |
The value can also be provided dynamically using workflow data.
This property is required.
Target Folder
Specifies the IB Drive folder to which the file will be moved.
The target folder can be specified using one of the following methods:
| Method | Description |
|---|---|
| Select Directory | Select the target folder by browsing IB Drive using the folder picker. |
| By Id | Specify the unique IB Drive item ID of the target folder. This is the default method. |
| By Path | Specify the logical path of the target folder within IB Drive, for example /Agents/InvoiceProcessing/Processed. |
The value can also be provided dynamically using workflow data.
This property is required.
If a file with the same name already exists in the target folder, the activity fails with an error.
The activity does not overwrite the existing file or automatically generate a different name.
Execution settings
Configure Wait All Incoming when execution paths converge, and On Error for failure handling. Select Inherit where available to use the workflow-level error policy.
Outputs
File
Returns an IB-X File Reference for the file at its new location in IB Drive. Bind the whole output to a compatible reference input, or use Id with an IB Drive By Id selector.
| Property | Description |
|---|---|
| Id | The unique identifier (GUID) of the moved file. |
| Name | The name of the moved file, including its file extension. |
| Location | The logical path of the file at its new location in IB Drive. |
| ParentId | The unique identifier (GUID) of the target folder containing the moved file. |
| Size | The size of the file in bytes. |
| MimeType | The MIME type of the file, for example application/pdf or text/plain. |
| Created | The UTC date and time when the file was originally created in IB Drive. |
| Modified | The UTC date and time when the file was last modified. |
The returned file metadata can be used by downstream activities to perform additional operations on the moved file.
Remarks
Use the returned reference for subsequent operations on the resulting item. IB Drive paths are logical library paths, not physical paths on the workflow host. The conflict and naming rules above apply when the activity executes.