Form File

Uncontrolled node

Overview

The Form File node retrieves file data from a form element that accepts file uploads. Use this node to access files uploaded by users through the UI form interface, outputting the file metadata that can be passed to other nodes for processing, storage, or analysis.

This node reads from the runtime form data and returns the file information (including the file ID, name, and access token) that was captured when a user uploaded a file through the specified form element.

Inputs

Input	Type	Description	Default
Page	DropDown	The display name of the form page containing the file element.	-
Element	DropDown	The display name of the specific file upload element within the page.	-

Outputs

Output	Type	Description
File	Data	The file metadata object containing id, name, fileToken, and other file properties.

Runtime Behavior

The Form File node operates as an uncontrolled data node, meaning it does not require an event trigger to execute. When the node runs, it:

1. Resolves the page and element display names to their internal IDs
2. Reads the file data from the runtime form state at formData/{pageId}/{elementId}
3. Outputs the file metadata object that was stored when the user uploaded the file

The output file object can be used with nodes such as Read PDF, Read Image, Write To Library, or Get Library Download URLs to access the actual file content.

File Upload Elements

This node works with form elements that have file upload capabilities. The file data is typically set using the Set Form File node or through direct user interaction with file upload UI components.

Example Usage

Scenario: Retrieve a PDF uploaded by a user and extract its text content.

1. Add a Form File node to your workflow
2. Set the Page input to the name of your form page (e.g., "Document Upload")
3. Set the Element input to the name of your file upload field (e.g., "Contract PDF")
4. Connect the File output to a Read PDF node's file input
5. Connect the Read PDF node's Done event to trigger further processing

This setup allows you to capture user-uploaded documents through the UI and immediately process them within your workflow.