Перейти к основному содержимому

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

Узел этого вида отправляет сообщения информационным системам по протоколу AMQP. Такими информационными системами, в частности, являются информационные базы «1С:Предприятия».

Добавление узла «Канал1СНазначение» на схему

примечание

При получении из узла Канал1СНазначение сообщения более 1 Мб его тело нужно скачивать отдельным запросом через служебный HTTP-сервис приложения /sys/binary/. Получение тела выполняется по ключу из значения параметра сообщения integ_message_body_key.

Пример
const protocol_http = "http";
const hostname = "localhost";
const port_http = 9090;
const application = "APPLICATION_NAME";

async function requestBody(id_token, integ_message_body_key) {
const url = `${protocol_http}://${hostname}:${port_http}/applications/${application}/sys/binary/${integ_message_body_key}`;

const response = await fetch(url, {
method: 'GET',
headers: {
'Authorization': `Bearer ${id_token}`
}
});

if (!response.ok) {
throw new Error(`HTTP error! status: ${response.status}`);
}

return await response.text();
}

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

  • Имя

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

  • Описание

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

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

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

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

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

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

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

Контекст: Офис запрашивает в магазине информацию об остатках товаров. Магазин получает запрос и отправляет в ответ отчет по остаткам. Офис получает ответ и сохраняет его в информационной базе. Офис и Магазин используют информационные системы на базе «1С».

Задача: Как системе «1С» получить сообщение из «1С:Шины»?

Решение: В «1С:Шину» сообщения попадают через узлы «Канал1Источник» (Офис ⟶ «ИзОфиса», Магазин ⟶ «ИзМагазина»). Для каждой системы, входящей в связанную с узлом группу участников, создается индивидуальная очередь: в эти очереди системы «1С» помещают сообщения. Далее используем узлы «Канал1Назначение» для того, чтобы доставить сообщение из «1С:Шины» в систему «1С». Каждый из этих узлов также соединен с соответствующей группой участников (ВМагазин ⟶ Магазин, ВОфис ⟶ Офис). Аналогично для каждой системы, входящей в связанную с узлом группу участников, создается индивидуальная очередь. Информационные системы подключаются к этим очередям и забирают из них сообщения: Магазин получает запрос об остатках, а Офис — отчет.

Схема процесса интеграции

Примеры​