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

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

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

Имя

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

Описание

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

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

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

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

Каталог

Имя каталога, в который «1С:Шина» запишет файл сообщения

ИмяФайла

Имя файла, в который будет записано сообщение

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

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

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

Кодировка, в которой FTP-серверу следует читать путь к файлу

ДействиеНадСуществующимФайлом

Что сделает «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-сервером

ВыборИмени

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

Пример:

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

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

Длительность хранения доставленных сообщений в формате ДД.ЧЧ

Определяет время, в течение которого будут храниться сообщения, доставленные в данный узел. Задается в пользовательском интерфейсе приложения, в карточке процесса интеграции, в свойствах узла. Недоступно в среде разработки.

Длительность задается в формате ДД:ЧЧ (например, 10:02 — 10 дней и 2 часа). Если указать длительность равную 00:00, то доставленные сообщения для данного узла не будут сохраняться в «1С:Шине». Длительность хранения должна быть равна 00:00 (по-умолчанию) либо больше или равна 00:01.

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

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

Задача: Записать сообщение из «1С:Шины» в файл, расположенный в определенном каталоге на FTP-сервере.

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