Все ноды/Integrations/Files
Поиск файлов
Возвращает список файлов, подходящих под glob-шаблон, относительно корня настроенного хранилища.
Тип в графе: file_glob
Exec
Можно включить ветку ошибки (expose_error_output) и обработать сбой отдельным путём.
Порты можно разделить на исполнение и данные (split ports).
Как попробовать
Минимальный рабочий воркфлоу
- Исполнение
- Исполнение + данные
Запускается сразу
Как применять
Нода отвечает на вопрос «какие файлы там есть». Она возвращает только метаданные — путь, размер и ссылку на файл; содержимое не читается. Дальше эти пути отдают Чтению файла в цикле, а список ссылок — на порт «Файлы» ноды Выход или в ноду Отправить сообщение в Telegram, чтобы отдать файлы пользователю.
Как это работает
Шаблон задаётся относительно корня хранилища и поддерживает *, ? и **. Тонкость,
которая объясняет большинство неожиданных результатов: пока в шаблоне нет **, звёздочка
проходит сквозь /, поэтому *.csv найдёт и reports/2026/q1.csv. Как только **
появляется, обычная * ограничивается одним сегментом пути, и рекурсию задаёт именно **
(например, reports/**/*.csv).
Глубину ограничивает «Макс. глубина каталогов»: 0 — только файлы в корне, потолок — 20.
Обход останавливается на «Макс. результатов» (потолок 500) и поднимает флаг truncated.
Папки в результат не попадают — только файлы.
Пустой список — это успешный запуск: значит, под шаблон ничего не подошло. Недоступное хранилище отказом ноды и остаётся, а не превращается в «папка пуста».
Частые ошибки
- Ожидание сортировки. Порядок — это порядок обхода хранилища, не имя и не дата. Сортируйте сами, если он важен.
- Ожидание содержимого. В выводе нет ни байта из файла. Читать — отдельным шагом.
- Большая глубина на WebDAV. На внешнем диске обход делает запрос на каждую папку, и
**по всему корню превращается в десятки запросов. Сужайте шаблон и глубину. - Абсолютный путь в шаблоне. Шаблон относительный, ведущий
/ничего не найдёт. truncatedбез обработки. Достигнутый предел выглядит как обычный результат: ветка, считающая «это все файлы», молча обработает часть.
Входы
| Порт | Провод | Данные | Примечания |
|---|---|---|---|
File storefile_store | Данныеdata | — | показывается, когда connection_source ≠ "auto" |
Выходы
| Порт | Провод | Данные | Примечания |
|---|---|---|---|
Successoutput | Исполнение + данныеexecute_data | object | |
Erroron_error | Исполнение + данныеexecute_data | — | показывается, когда expose_error_output = true |
Filesfiles | Данныеdata | file |
Настройки
| Поле | Тип | По умолчанию | Описание |
|---|---|---|---|
Glob-шаблонpattern | string | * | Относительно корня хранилища; поддерживает *, ? и ** (рекурсивно). Шаблоны рендерятся, поэтому листинг по сессии — это `sessions/{{ variables.sid }}/*.json`. поддерживает шаблоны |
Источник подключенияconnection_source | string | auto | Откуда нода берёт подключение. «Из контекста рана» использует то, что платформа уже знает (Telegram-бот, в который задеплоен этот воркфлоу / собственное файловое хранилище этого воркспейса), и не требует проводов. «Внешнее подключение» показывает ресурсный порт, чтобы в него можно было подключить конфиг-ноду. Варианты: |
Подпапкаstore_subfolder | string | "" | Необязательная папка внутри хранилища этого воркспейса, которую считать корнем, напр. `reports` или `sessions/{{ variables.session_id }}`. Пусто = корень хранилища. поддерживает шаблоны показывается при connection_source = auto |
| Дополнительно | |||
Макс. результатовmax_results | integer | 200 | Останавливаться после этого числа путей; при достижении лимита в выводе поднимается флаг `truncated`. |
Макс. глубина каталоговmax_depth | integer | 10 | 0 = только файлы в корневой папке. |
Общие поля
Эти три поля есть у каждой ноды: платформа добавляет их сама, а не автор ноды.
expose_error_output— Если включено, показывает выход выполнения для подключения нод, которые запускаются при сбое этого шага.split_ports_in— Показывать отдельные порты входа для выполнения и данных вместо одного объединённого.split_ports_out— Показывать отдельные порты выхода для выполнения и данных вместо одного объединённого.