Свойства узла процесса интеграции вида «FtpИсточник»
Узел этого вида получает файлы из каталога по протоколу FTP.
При работе с файлами может возникнуть ситуация, когда узел «FtpИсточник» реагирует на изменение файла до того, как это изменение завершилось. Обычно такое случается при работе с большими файлами или при медленной записи. Это происходит потому, что узел «FtpИсточник» несколько раз в секунду контролирует указанные ему каталоги и/или файлы и генерирует сообщения при изменении даты или размера файла. В результате может быть сгенерировано больше одного сообщения до завершения записи в файл. Вы можете узнать подробнее о решении данной проблемы в соответствующей статье раздела Проблемы.
Свойства узла
ВыборИмени
Обработчик, который предназначен для того, чтобы вы могли переопределить значение свойства ИмяФайла — имя файла сообщения, который будет искать «1С:Шина». Обработчик должен вернуть имя файла. Если заполнено свойство ИмяФайла и указан обработчик ВыборИмени, то имя файла будет браться из обработчика. В случае ошибки в обработчике имя файла будет взято из свойства ИмяФайла.
ВыборИмениПослеЧтения
Обработчик, который предназначен для того, чтобы вы могли переопределить значение свойства ИмяПослеЧтения — имя файла, которое он будет иметь после чтения «1С:Шиной». Обработчик должен вернуть имя файла (подробнее). Если заполнено свойство ИмяПослеЧтения и указан обработчик ВыборИмениПослеЧтения, то имя файла будет браться из обработчика. В случае ошибки в обработчике имя файла будет взято из свойства ИмяПослеЧтения.
Пример:
метод ВыборИмениПослеЧтения(Контекст: МойПроцессИнтеграции.КонтекстВызова,
Сообщение: МойПроцессИнтеграции.Сообщение): Строка
возврат Сообщение.АбсолютныйПутьФайла + (Сообщение.ПолучитьПараметр("ВидСодержимого") как Строка)
;
ДействиеПослеЧтения
Переместить
После чтения «Шина» переместит файл сообщения. Новый путь к файлу она определит по значению свойства ИмяПослеЧтения и в результате обработки события ВыборИмениПослеЧтения
Сохранить
После чтения файл сообщения останется на месте. «Шина» вычислит для него идемпотентный ключ, который содержит полный путь к файлу, размер файла и момент модификации файла с точностью до секунд
«Шина» повторно обработает этот файл, только если изменится ключ этого файла, например в этот файл что-то будет дописано или файл будет перезаписан целиком (подробнее)
Удалить
После чтения «Шина» удалит файл сообщения
ЗадержкаПереподключения
Интервал между попытками подключения к FTP-серверу
Имя
Имя узла, уникальное в рамках процесса интеграции. Используется для обращения к узлу в коде (УзелСхемыИнтеграции.Имя). Должно начинаться с буквы, за которой следуют буквы, цифры или символы '_' (нижнее подчеркивание). Минимальная длина — 2 символа
ИмяПользователя
Имя пользователя для подключения к удаленному компьютеру
ИмяПослеЧтения
Имя, которое «Шина» присвоит файлу сообщения после чтения. Путь к файлу она вычислит относительно значения свойства Каталог (подробнее)
ИмяФайла
Имя файла сообщения, который будет искать «1С:Шина» (подробнее)
ИскатьВКаталогеРекурсивно
Если значение свойства равно Ложь, то «Шина» будет искать файлы сообщений только в каталоге, указанном в свойстве Каталог. Иначе будет искать еще и во всех его вложенных каталогах, используя свойства МаскаВключенияФайлов и МаскаИсключенияФайлов (подробнее)
ИспользоватьИмяФайлаБезПути
Если Истина, то «Шина»проигнорирует путь к файлу и включит в сообщение только имя файла. Иначе «Шина» включит в сообщение путь относительно значения свойства Каталог
Каталог
Имя каталога, в котором находятся файлы сообщений (подробнее)
Кодировка
Кодировка, в которой «Шина» прочитает содержимое файла сообщения
КодировкаИменФайлов
Кодировка, в которой «Шину» следует читать путь к файлу
МаксимумПопытокПереподключения
Максимальное количество попыток повторного подключения к FTP-серверу. Используйте 0, чтобы не пытаться подключиться повторно
МаскаВключенияФайлов
Маска, задающая имена файлов для включения в поиск (подробнее)
МаскаИсключенияФайлов
Маска, задающая имена файлов для исключения из поиска (подробнее)
МенятьКаталогПошагово
При подключении к некоторым FTP-серверам в команде cd сразу можно указать целевой каталог, например:
cd dir/subdir/subsubdir
Для таких серверов мы рекомендуем устанавливать значение этого свойства Ложь.
В других FTP-серверах нужно выполнить несколько команд последовательно, например:
cd dir cd subdir/ cd subsubdir
Обычно это связано с настроенным на сервере разграничением доступа. Для таких серверов устанавливайте значение этого свойства Истина
ОбновлениеМетрик
Обработчик, внутри которого можно обновлять метрики, добавленные в проект разработчиком. Пример:
// Разработчик добавил в проект метрику «РазмерФайлов». Тогда обновить метрику в узлах можно следующим образом:
метод ОбновлениеМетрик(Контекст: МойПроцессИнтеграции.КонтекстВызова, Сообщение: МойПроцессИнтеграции.Сообщение)
пер РазмерФайлов = МойПроцессИнтеграции.Метрики["РазмерФайлов"]
РазмерФайлов.Обновить(Сообщение.УзлыПути.Текущий.Узел.Имя, 1)
;
Описание
Произвольное описание узла для разработчика. Используется при редактировании схемы процесса интеграции. Недоступно из кода
Пароль
Пароль пользователя для подключения к удаленному компьютеру
ПассивныйРежим
Если значение свойства равно Истина, то используется пассивный режим FTP. Иначе используется активный режим FTP
Порт
Порт, по которому устанавливается соединение с удаленным компьютером
Скачивать
Если установлено значение Истина, то файл скачивается с FTP-сервера и помещается в тело сообщения. Если установлено значение Ложь, тело сообщения будет пустым.
Некоторые FTP-сервера позволяют загружать файлы, только если значение свойства МенятьКаталогПошагово установлено Истина, в то время как другие могут загружать файлы только при значении свойства МенятьКаталогПошагово равным Ложь.
Таймаут
Период времени, в течение которого сервер «Шины» (после подключения) будет ожидать выполнения запрошенной операции FTP-сервером
ТаймаутПодключения
Период времени, в течение которого сервер «Шины» будет ожидать установления подключения к FTP-серверу
Хост
Имя или IP-адрес удаленного компьютера, с которым «Шина» устанавливает соединение
Пример использования
Контекст: Есть каталог на FTP-сервере, в котором периодически появляются файлы. Из содержимого этих файлов формируются сообщения и передаются системе-получателю, где записываются в файлы в определенном каталоге.
Задача: Сформировать сообщение из содержимого файлов, которые появляются в каталоге на FTP-сервере, и передать это содержимое в сервис интеграции «1С:Предприятия».
Решение: Чтобы сформировать сообщение из файлов, появляющихся в каталоге на FTP-сервере, добавим на схему узел «FtpИсточник». Чтобы передать сообщение в сервис интеграции «1С:Предприятия», используем узел «Канал1СНазначение».
