Свойства узла процесса интеграции вида «FtpИсточник»

Узел этого вида получает файлы из каталога по протоколу FTP.

Внимание: При работе с файлами может возникнуть ситуация, когда узел «FtpИсточник» реагирует на изменение файла до того, как это изменение завершилось. Обычно такое случается при работе с большими файлами или при медленной записи. Это происходит потому, что узел «FtpИсточник» несколько раз в секунду контролирует указанные ему каталоги и/или файлы и генерирует сообщения при изменении даты или размера файла. В результате может быть сгенерировано больше одного сообщения до завершения записи в файл. Вы можете узнать подробнее о решении данной проблемы в соответствующей статье раздела Проблемы.

Свойства узла

Имя

Имя узла, уникальное в рамках процесса интеграции. Используется для обращения к узлу из встроенного языка (УзелСхемы.Имя). Должно начинаться с буквы, за которой следуют буквы, цифры или символы '_' (нижнее подчеркивание). Минимальная длина — 2 символа

Описание

Произвольное описание узла для разработчика. Используется при редактировании схемы процесса интеграции. Недоступно из встроенного языка

ОбновлениеМетрик

Обработчик, внутри которого можно обновлять метрики, добавленные в проект разработчиком. Пример:

// Разработчик добавил в проект метрику «СчетчикВУзле». Тогда обновить метрику в узлах
// можно следующим образом:
метод ОбновлениеМетрик(Контекст: МойПроцессИнтеграции.КонтекстВызова, Сообщение: МойПроцессИнтеграции.Сообщение)
    пер СчетчикВУзле = МойПроцессИнтеграции.Метрики["СчетчикВУзле"]
    СчетчикВУзле.Обновить(Сообщение.УзлыПути.Текущий.Узел.Имя, 1)
;

Каталог

Имя каталога, в котором находятся файлы сообщений (подробнее)

ИскатьВКаталогеРекурсивно

Если значение свойства равно Ложь, то «1С:Шина» будет искать файлы сообщений только в каталоге, указанном в свойстве Каталог. Иначе будет искать еще и во всех его вложенных каталогах, используя свойства МаскаВключенияФайлов и МаскаИсключенияФайлов (подробнее)

ИмяФайла

Имя файла сообщения, который будет искать «1С:Шина» (подробнее)

МаскаВключенияФайлов

Маска, задающая имена файлов для включения в поиск (подробнее)

МаскаИсключенияФайлов

Маска, задающая имена файлов для исключения из поиска (подробнее)

ИспользоватьИмяФайлаБезПути

Если Истина, то «1С:Шина»проигнорирует путь к файлу и включит в сообщение только имя файла. Иначе «1С:Шина» включит в сообщение путь относительно значения свойства Каталог

Кодировка имен файлов

Кодировка, в которой «1С:Шине» следует читать путь к файлу

ДействиеПослеЧтения

Переместить: После чтения «1С:Шина» переместит файл сообщения. Новый путь к файлу она определит по значению свойства ИмяПослеЧтения и в результате обработки события ВыборИмениПослеЧтения
Удалить: После чтения «1С:Шина» удалит файл сообщения
Сохранить: После чтения файл сообщения останется на месте. «1С:Шина» вычислит для него идемпотентный ключ, который содержит полный путь к файлу, размер файла и момент модификации файла с точностью до секунд; «1С:Шина» повторно обработает этот файл, только если изменится ключ этого файла, например в этот файл что-то будет дописано или файл будет перезаписан целиком (подробнее)

ИмяПослеЧтения

Имя, которое «1С:Шина» присвоит файлу сообщения после чтения. Путь к файлу она вычислит относительно значения свойства Каталог (подробнее)

Кодировка

Кодировка, в которой «1С:Шина» прочитает содержимое файла сообщения

Хост

Имя или IP-адрес удаленного компьютера, с которым «1С:Шина» устанавливает соединение

Порт

Порт, по которому устанавливается соединение с удаленным компьютером

ИмяПользователя

Имя пользователя для подключения к удаленному компьютеру

Пароль

Пароль пользователя для подключения к удаленному компьютеру

ПассивныйРежим

Если значение свойства равно Истина, то используется пассивный режим FTP. Иначе используется активный режим FTP

МенятьКаталогПошагово

При подключении к некоторым FTP-серверам в команде cd сразу можно указать целевой каталог, например:

cd dir/subdir/subsubdir

Для таких серверов мы рекомендуем устанавливать значение этого свойства Ложь.

В других FTP-серверах нужно выполнить несколько команд последовательно, например:

cd dir cd subdir/ cd subsubdir

Обычно это связано с настроенным на сервере разграничением доступа. Для таких серверов устанавливайте значение этого свойства Истина

МаксимумПопытокПодключения

Максимальное количество попыток повторного подключения к FTP-серверу. Используйте 0, чтобы не пытаться подключиться повторно

ТаймаутПодключения

Период времени, в течение которого сервер «1С:Шины» будет ожидать установления подключения к FTP-серверу

ЗадержкаПовторногоПодключения

Интервал между попытками подключения к FTP-серверу

Таймаут

Период времени, в течение которого сервер «1С:Шины» (после подключения) будет ожидать выполнения запрошенной операции FTP-сервером

Скачивать

Если установлено значение Истина, то файл скачивается с FTP-сервера и помещается в тело сообщения. Если установлено значение Ложь, тело сообщения будет пустым.

Важно: Некоторые FTP-сервера позволяют загружать файлы, только если значение свойства МенятьКаталогПошагово установлено Истина, в то время как другие могут загружать файлы только при значении свойства МенятьКаталогПошагово равным Ложь.

ВыборИмени

Обработчик, который предназначен для того, чтобы вы могли переопределить значение свойства ИмяФайла — имя файла сообщения, который будет искать «1С:Шина». Обработчик должен вернуть имя файла. Если заполнено свойство ИмяФайла и указан обработчик ВыборИмени, то имя файла будет браться из обработчика. В случае ошибки в обработчике имя файла будет взято из свойства ИмяФайла.

ВыборИмениПослеЧтения

Обработчик, который предназначен для того, чтобы вы могли переопределить значение свойства ИмяПослеЧтения — имя файла, которое он будет иметь после чтения «1С:Шиной». Обработчик должен вернуть имя файла (подробнее). Если заполнено свойство ИмяПослеЧтения и указан обработчик ВыборИмениПослеЧтения, то имя файла будет браться из обработчика. В случае ошибки в обработчике имя файла будет взято из свойства ИмяПослеЧтения.

Пример:

метод ВыборИмениПослеЧтения(Контекст: СетьМагазинов.КонтекстВызова, 
                            Сообщение: СетьМагазинов.Сообщение): Строка

    возврат Сообщение.АбсолютныйПутьФайла 
            + (Сообщение.ПолучитьПараметр("ВидСодеримого") как Строка)
;

Пример использования

Контекст: Есть каталог на FTP-сервере, в котором периодически появляются файлы. Из содержимого этих файлов формируются сообщения и передаются системе-получателю, где записываются в файлы в определенном каталоге.

Задача: Сформировать сообщение из содержимого файлов, которые появляются в каталоге на FTP-сервере и передать это содержимое дальше по схеме интеграции.

Решение: Для того, чтобы сформировать сообщение из файлов, появляющихся в каталоге на FTP-сервере, добавим на схему узел «FtpИсточник». Для того, чтобы записать сообщение в файл в каталоге получателя, используем узел «ФайлНазначение». Свяжем его с группой участников для того, чтобы использовать их реквизиты при заполнении свойств узла, например, при указании каталога.