Skip to main content
Version: Current

Get File

Description​

Retrieves a file from Google Drive and returns a File Reference.

This activity is commonly used when subsequent activities require a File Reference instead of manually selecting a file.

Common Capabilities​

Process Data Support​

info

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.

File​

The file to retrieve.

You can:

  • Select a file using the Google Drive Picker.
  • Provide a File Reference returned by a previous activity.
  • Provide a file identifier dynamically through Process Data.

Wait All Incoming​

Execution Control

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​

Error Handling Strategy

Defines how the workflow behaves if this activity encounters a runtime error.

Supported strategies include:

  • Fault
  • Continue
  • Suspend
  • Retry

Learn more → Error Handling

Output​

File​

A File Reference representing the selected file. File References are a platform-wide IB-X file abstraction that can be passed to other activities that accept file inputs.

PropertyDescription
NameName of the file.
SizeFile size in bytes. May be empty when not available.
File IDUnique identifier of the file in Google Drive.
MIME TypeMIME type of the file.
Parent FolderParent folder containing the file.
Created TimeWhen the file was created.
Modified TimeWhen the file was last modified.
Web View LinkLink to view the file in Google Drive.

For additional details, see Google Drive Picker.

Remarks​

  • The authenticated Google account must have access to the file.
  • This activity does not download the file contents.
  • Use activities such as Download File when the file contents are required.
  • The returned File Reference can be passed directly to any IB-X activity that accepts file inputs.