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

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

Имя

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

Описание

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

Каталог

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

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

Если значение свойства равно Ложь, то «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-сервера и помещается в тело сообщения. Если установлено значение Ложь, тело сообщения будет пустым.

Обработчик определения имени

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

Обработчик определения имени после чтения

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

Пример:

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

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

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

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

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

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