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

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

Имя

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

Описание

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

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

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

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

Каталог

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

ИмяФайла

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

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

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

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

Что сделает «1С:Шина», если уже существует файл, в который нужно записать тело сообщения:

Перезаписывать

Перезапишет существующий файл

Дописывать

Допишет тело сообщения в конец существующего файла. Такой файл будет содержать тела нескольких сообщений

ВыдаватьОшибку

Не изменит существующий файл и вызовет исключение. Сообщение не будет считаться доставленным

Оставлять

Не изменит существующий файл. Сообщение будет считаться доставленным

РазрешитьПустойФайл

Будет ли «1С:Шина» создавать пустые файлы для сообщений с пустым телом.

Если Истина, то она создаст пустой файл сообщения.

Если Ложь, то она не создаст файл сообщения и вызовет исключение.

Если Истина и ДействиеНадСуществующимФайлом равно Перезаписывать, то вместо существующего файла она запишет пустой файл.

Если Истина и ДействиеНадСуществующимФайлом равно Дописывать, то существующий файл останется неизменным

Кодировка

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

ВыборИмени

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

Пример:

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

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

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

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

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

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

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

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

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