Find Library Files
Uncontrolled node
Overview
The Find Library Files node searches your project's library for documents matching a specified filename. It returns an array of file objects containing the document ID and name for each match found. This node is useful for dynamically locating files in your library to process them in subsequent nodes.
Unlike controlled nodes, Find Library Files runs automatically whenever its inputs change, immediately outputting the search results without requiring an event trigger.
Inputs
| Input | Type | Description | Default |
|---|---|---|---|
| Name | Text | The filename or pattern to search for in the library. | - |
Properties
| Property | Type | Description | Default |
|---|---|---|---|
| Case Insensitive | Boolean | When enabled, the search ignores case differences (e.g., "Report" matches "report"). | false |
Outputs
| Output | Type | Description |
|---|---|---|
| Files | Array | An array of file objects matching the search criteria. Each object contains id (the document ID) and name (the filename). Returns 'undefined' if no matches are found or if the project ID is unavailable. |
Runtime Behavior
This node executes immediately when the Name input changes or when the workflow starts. It queries the project library using the provided name filter and returns all matching documents.
- If Case Insensitive is set to
true, the search will match files regardless of capitalization. - If no files match the search criteria, the node outputs
'undefined'. - The node requires a valid project context to access the library; if unavailable, it outputs
'undefined'.
Example Usage
Scenario: Locate a specific PDF document in your library to extract text from it.
- Add a Text node and set its value to
"contract.pdf"(or a partial name like"contract"). - Connect the Text node's output to the Name input of the Find Library Files node.
- Connect the Files output to a Read PDF node's File input.
- Optionally, enable Case Insensitive in the properties panel if you're unsure of the exact capitalization.
When the workflow runs, Find Library Files will search the library for matching documents and pass the file reference(s) to the Read PDF node for processing.