Get File
Description
The Get File activity retrieves a specified file from IB Drive and returns it as an IB-X File Reference.
The returned File Reference includes information about the file and can be passed to downstream activities that accept file inputs.
Common Capabilities
Process Data Support
This activity supports dynamic configuration using variables from the Process Data drawer.
You can bind values from Model Data, Form Data, System Data, Enterprise Variables, and Activity Outputs.
Learn more → Using Process Data
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 retrieved.
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.
Wait All Incoming
Controls how this activity behaves when multiple incoming execution paths converge.
Determines whether the activity executes when:
- any incoming path completes, or
- all relevant incoming paths complete before execution
Learn more → Execution Control
On Error
Defines how the workflow behaves if this activity encounters a runtime error.
Supported strategies include Fault, Continue, Suspend, and Retry.
Outputs
File
Returns an IB-X File Reference representing the specified IB Drive file.
The File Reference provides access to the file and its associated metadata.
| Property | Description |
|---|---|
| ItemId | The unique identifier (GUID) of the file in IB Drive. |
| Name | The name of the file, including its file extension. |
| Location | The logical path of the file within IB Drive, for example /Agents/InvoiceProcessing/Input/Invoice.pdf. |
| ParentId | The unique identifier (GUID) of the parent folder containing the file. |
| Size | The size of the file in bytes. |
| ContentType | The MIME type of the file, for example application/pdf or text/plain. |
| Created | The UTC date and time when the file was created in IB Drive. |
| Modified | The UTC date and time when the file was last modified. |
Using the File Reference
File Reference is the standard IB-X abstraction for representing files across activities.
The File output can be passed directly to downstream activities that accept a File Reference as an input, avoiding the need to download the file to the local file system.
Examples include:
- Document processing activities
- Email attachment activities
- AI activities that accept file inputs
- File management activities
- Other supported storage and integration activities
Remarks
- The specified file must exist in IB Drive when the activity executes.
- The activity retrieves a reference to the file and does not modify the file or its contents.
- When using By Path, specify the complete logical IB Drive path including the file name and extension.
- The returned File Reference can be passed to compatible downstream activities without requiring a local file system path.