SMB

Общее описание

Блок SMB обеспечивает работу с файлами на сетевых ресурсах Windows и Samba-серверах по протоколу SMB. Позволяет скачивать, загружать и мониторить файлы в сетевых папках.

Блок SMB может использоваться в качестве:

• блока отправителя

• блока получателя

Настройка блока

В данном разделе описаны параметры блока SMB, которые необходимо заполнить при его настройке.

Базовые параметры

Название в UI	Название атрибута	Описание	Значение по умолчанию	Тип данных
Dynamic Endpoint	dynamicEndpoint	Доступен только для блоков-отправителей Позволяет включить встроенную функциональность динамического определения вызываемой конечной точки. При включении структура блока меняется: вместо to используется "toD", а значение вызываемого ресурса может собираться из переменной (например, ${header.foo}).	False	Логическое значение
Hostname	hostname	Обязательный параметр Адрес сервера.		Строка
Connection	connection	Позволяет выбрать предсозданное подключение к серверу или создать новое с помощью визарда Connection Manager.		Список
Description	description	Краткое описание блока.		Строка
Port	port	Порт сервера.		Целочисленное значение
Share Name	shareName	Обязательный параметр Обязательное имя директории‑общего ресурса (share directory), используемой для обмена данными. Параметр задает идентификатор общего ресурса, к которому осуществляется доступ. Должен быть указан при настройке — без него работа с общим ресурсом невозможна.		Строка
Path	path	Обязательный параметр Базовая директория внутри общего ресурса (shareName), определяющая путь для операций чтения/записи данных. Задает подпуть в рамках указанного общего ресурса. Позволяет организовать структуру каталогов и разграничить зоны доступа.		Строка
Search Pattern	searchPattern	Шаблон поиска файлов на сервере (SMB). Определяет, какие файлы будут перечислены в каталоге. Поддерживает два символа‑подстановки: "?" (один любой символ) и "*" (любая последовательность символов). Если параметр пуст или не задан — выбираются все файлы в каталоге.	*.txt	Строка
Recursive	recursive	Доступен только для блоков-получателей Определяет, должен ли получатель при обработке каталога выполнять поиск файлов во всех вложенных подкаталогах. Возможные значения: true — поиск выполняется рекурсивно: обрабатываются файлы в указанном каталоге и во всех его подкаталогах (на любой глубине вложенности). false — обрабатываются только файлы, находящиеся непосредственно в указанном каталоге, без учёта вложенных папок.	False	Логическое значение
Send Empty Message When Idle	sendEmptyMessageWhenIdle	Доступен только для блоков-получателей Определяет, должен ли получатель отправлять пустое сообщение (без тела) в случае, если при опросе не было получено новых данных (файлов). Возможные значения: true — если при опросе новые данные не найдены, отправляется пустое сообщение. Полезно для поддержания активности потока, индикации работы компонента или триггеринга последующих этапов обработки. false — если данных нет, сообщение не отправляется. Снижает нагрузку на систему и объём трафика за счёт отсутствия «пустых» событий.	False	Логическое значение
Backoff Error Threshold	backoffErrorThreshold	Количество последовательно полученных ошибок обработки, после которого планировщик переходит в режим пропуска запусков.		Целое число
Backoff Idle Threshold	backoffIdleThreshold	Количество последовательных запросов, не приведших к созданию или обработке данных.		Целое число
Backoff Multiplier	backoffMultiplier	Количество пропусков срабатываний планировщика после достижения порогов Backoff Error Threshold или Backoff Idle Threshold. Применяется, если эти параметры заданы.		Целое число
Auto Create	autoCreate	Доступен только для блоков-отправителей Задает автоматическое создание отсутствующих каталогов в пути к файлу. Для получателя — создание начального каталога. Для отправителя — каталога для записи файлов.	True	Логическое значение
File Exist	fileExist	Определяет действие, если файл с таким же именем уже существует. Возможные значения: Override — заменяет существующий файл. Append — добавляет содержимое к существующему файлу. Fail — выбрасывает исключение GenericFileOperationException, указывая, что файл уже существует. Ignore — молча игнорирует проблему и не перезаписывает существующий файл, предполагая, что все в порядке. Move — перемещает существующий файл перед записью целевого. Требует настройки опции moveExisting. Для управления поведением при наличии файла в целевой директории можно использовать опцию eagerDeleteTargetFile. TryRename — применимо только при использовании опции tempFileName. Пытается переименовать файл из временного имени в фактическое без проверки существования, что может быть быстрее на некоторых файловых системах и FTP‑серверах.	Ignore	Список
Buffer Size	bufferSize	Доступен только для блоков-отправителей Размер буфера в байтах в режиме потоковой загрузки.	2048	Целое число
Backoff Error Threshold	backoffErrorThreshold	Количество последовательно полученных ошибок обработки, после которого планировщик переходит в режим пропуска запусков.		Целочисленное значение
Backoff Idle Threshold	backoffIdleThreshold	Количество последовательных запросов, не приведших к созданию или обработке данных.		Целочисленное значение
Backoff Multiplier	backoffMultiplier	Количество пропусков срабатываний планировщика после достижения порогов Backoff Error Threshold или Backoff Idle Threshold. Применяется, если эти параметры заданы.		Целочисленное значение
Delay	delay	Промежуток времени в миллисекундах до следующего запроса.	500	Целочисленное значение
Greedy	greedy	Если True, после срабатывания ScheduledPollConsumer (при создании/обработке данных) он запускается еще раз сразу.	False	Логическое значение
Initial Delay	initialDelay	Промежуток времени в миллисекундах до первого запроса.	1 000	Целочисленное значение
Repeat Count	repeatCount	Максимальное количество срабатываний планировщика. Значение 0 или отрицательное означает бесконечное выполнение без ограничений.	0	Целочисленное значение
Run Logging Level	runLoggingLevel	Уровень логирования старта и финиша инициации потока. Возможные значения: TRACE DEBUG INFO WARN ERROR OFF	TRACE	Список
Scheduled Executor Service	scheduledExecutorService	Позволяет настроить пользовательский/общий пул потоков для получателя. По умолчанию у каждого получателя свой однопоточный пул.		Строка
Scheduler	scheduler	Определяет cron‑планировщик из компонентов camel‑spring или camel‑quartz. Для встроенного планировщика используйте spring или quartz.	none	Строка
Scheduler Properties	schedulerProperties	Дополнительные свойства для пользовательского планировщика или планировщиков на базе Quartz и Spring.		Строка
Start Scheduler	startScheduler	Определяет, будет ли планировщик запускаться автоматически.	True	Логическое значение
Time Unit	timeUnit	Единицы измерения времени для параметров Initial Delay и Delay. Возможные значения: Nanoseconds Microseconds Milliseconds Seconds Minutes Hours Days	Milliseconds	Список
Use Fixed Delay	useFixedDelay	Определяет режим выполнения: фиксированная задержка или фиксированная частота.	True	Логическое значение

Расширенные параметры

Название в UI	Название атрибута	Описание	Значение по умолчанию	Тип данных
Bridge Error Handler	bridgeErrorHandler	Доступен только для блоков-получателей Определяет, должен ли коннектор передавать ошибки, возникающие при получении сообщений, в обработчик ошибок Camel (Error Handler). При активации позволяет интегрировать обработку ошибок с маршрутизацией Camel.	False	Логическое значение
Exception Handler	exceptionHandler	Доступен только для блоков-получателей Позволяет указать пользовательский обработчик исключений (ExceptionHandler) для получателя . По умолчанию получатель обрабатывает исключения самостоятельно: они логируются на уровне WARN или ERROR и игнорируются. При указании кастомного обработчика можно реализовать индивидуальную логику реагирования на ошибки (логирование, повторные попытки, перезапуск и т. д.).		Строка
Exchange Pattern	exchangePattern	Доступен только для блоков-получателей Задает шаблон взаимодействия между компонентами в интеграционном потоке. Определяет способ передачи сообщений и ожидания ответа. Возможные значения: InOnly (однонаправленный вызов: сообщение отправляется, ответ игнорируется). InOut (двунаправленный вызов: ожидается ответ от хранимой процедуры, который будет передан дальше по потоку). Выбор шаблона влияет на то, как компонент обрабатывает результат выполнения процедуры и передает его следующему шагу потока.		Строка
Poll Strategy	pollStrategy	Доступен только для блоков-получателей Плагин org.apache.camel.PollingConsumerPollingStrategy позволяет настроить собственную реализацию для управления обработкой ошибок, которые возникают во время операции опроса до создания и маршрутизации обмена в Camel.		Строка
Lazy Start Producer	lazyStartProducer	Определяет, должен ли отправитель стартовать в отложенном режиме (при получении первого сообщения). Отложенный запуск полезен, если запуск отправителя может завершиться неудачей и привести к сбою при старте потока. При отложенном запуске сбой можно обработать во время маршрутизации сообщений с помощью обработчиков ошибок. Примечание: При обработке первого сообщения создание и старт отправителя могут занять время и увеличить общее время обработки.	False	Логическое значение
Idempotent Repository	idempotentRepository	Определяет репозиторий для отслеживания уже обработанных сообщений (предотвращение дублирования). Используется механизм org.apache.camel.spi.IdempotentRepository.		Строка
Smb Config	smbConfig	Расширенная конфигурация SMB‑клиента. Позволяет задать специфические настройки клиента, например тайм‑ауты и параметры соединения.		Строка
Smb Io Bean	smbIoBean	опциональный компонент (bean) для настройки атрибутов доступа к файлам при операциях чтения/записи через протокол SMB		Строка
Pattern	pattern	Доступен только для блоков-отправителей Шаблон взаимодействия (Exchange Pattern) для обмена сообщениями. Определяет направление потока данных между его компонентами. Возможные значения: InOnly (однонаправленный вызов: сообщение отправляется, ответ игнорируется). InOut (двунаправленный вызов: ожидается ответ от хранимой процедуры, который будет передан дальше по потоку). Выбор шаблона влияет на то, как компонент обрабатывает результат выполнения процедуры и передает его следующему шагу потока.		Список
Disabled	disabled	Доступен только для блоков-отправителей Определяет, будет ли блок отключен в потоке. В активированном потоке функциональность блока не будет отрабатываться.	False	Логическое значение

Параметры безопасности

Название в UI	Название атрибута	Описание	Значение по умолчанию	Тип данных
Domain	domain	Указывает домен пользователя для аутентификации в рамках системы безопасности Bercut ESB. Используется при настройке защищенных соединений и проверке прав доступа.		Строка
Password	password	Пароль для авторизации на сервере.		Строка
Username	username	Имя пользователя для авторизации на сервере.		Строка