Skip to main content
Version: Current

Get File

Description​

Retrieves a file from Google Drive and returns a File Reference along with its metadata.

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.

Examples include:

  • Google Drive activities
  • Azure AI activities
  • Document processing activities
  • File management activities
  • Email attachment activities

Metadata​

Metadata describing the file.

Common metadata includes:

  • 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 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.