Get Files
Description
Retrieves files from a Google Drive folder and returns their File References and metadata.
The activity can optionally search subfolders recursively.
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
A user-defined name for the activity, displayed on the workflow canvas to help identify its purpose.
Connection Name
The configured Google Drive connection used to access Google Drive resources.
Parent Folder
The folder from which files will be retrieved.
You can:
- Select a folder using the Google Drive Picker.
- Provide a File Reference representing a folder.
- Provide a folder identifier dynamically through Process Data.
Include Sub Folders
Determines whether files are retrieved only from the specified folder or from all nested subfolders.
| Value | Behavior |
|---|---|
| False | Retrieves files only from the specified folder. |
| True | Retrieves files from the specified folder and all subfolders recursively. |
Default value: False
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
- Retry
Output
Files
A collection of files retrieved from the specified folder.
Each item contains:
- A File Reference
- Metadata describing the file
The returned File References can be passed directly to other IB-X activities that accept file inputs.
Metadata
Each file includes metadata such as:
- File ID
- File Name
- MIME Type
- Parent Folder
- Created Time
- Modified Time
- Web View Link
For details, see:
Remarks
- The authenticated Google account must have access to the specified folder.
- Only files accessible to the authenticated account are returned.
- When Include Sub Folders is enabled, all nested folders are searched recursively.
- Large folder structures may increase execution time when recursive search is enabled.