OneDrive: Download File
Controlled node
Overview
Downloads a selected file from a connected Microsoft OneDrive account and imports it into the project library as a temporary file. Use this node when a workflow needs to pull a file from OneDrive before reading, processing, or transforming it inside Intellectible.
The node uses the panel UI to select a OneDrive connection and browse files. At runtime, it downloads the selected file, uploads it into the Intellectible library, removes the temporary local copy, and returns a library file object.
This node requires a configured OneDrive connection for the project. The connection selector only shows project connections with the ms-onedrive service.
Inputs
| Input | Type | Description | Default |
|---|---|---|---|
| Run | Event | Triggers the download operation. | - |
| Source | Data | External file source selection. Configure this in the panel UI by selecting a OneDrive connection and file. | - |
Outputs
| Output | Type | Description |
|---|---|---|
| Done | Event | Fires when the node has finished running. |
| Output | Data | The downloaded temporary library file object. Returns null if the drive or file cannot be resolved. |
Runtime Behavior and Defaults
- Controlled Node: The node runs only when the Run event fires.
- Project Requirement: A runtime project ID is required so the node can use the project connection and library.
- Connection Selection: The panel UI stores the selected OneDrive connection on the node.
- Drive Resolution: The runtime asks OneDrive for available drives and uses the first drive returned.
- File Selection: If a file list is available, the runtime downloads the first selected file. Otherwise it falls back to the file stored in the connection data.
- Temporary Library File: The downloaded file is uploaded as a temporary library file and output without the local
filePath. - Error Handling: If no drive or file ID is available, Output is set to
null.
Example Usage
Download and Read a PDF
- Add a OneDrive:Download File node.
- In the panel UI, select the OneDrive connection and file.
- Trigger Run from a Start node or another event.
- Connect Output to Read PDF, Read Image, Read DOCX, or another file reader.
The node downloads the OneDrive file and returns a temporary library file reference for downstream nodes.
Use Write To Library if you need to persist the downloaded temporary file in a specific library folder.