Работа с доставленными сообщениями
В «1С:Шине» для некоторых узлов имеется возможность хранить сообщения, которые были в них доставлены. Хранение доставленных сообщений можно настроить для следующих узлов:
- FtpНазначение
- JmsНазначение
- RabbitMqНазначение
- Канал1СНазначение
- ФайлНазначение
- ОчередьШиныНазначение
- Http
- Sql
Длительность хранения сообщений задается в панели управления приложением, в карточке процесса интеграции, в свойствах узла. Чтобы открыть свойства узла, на схеме процесса интеграции следует кликнуть на нужный узел:
В поле Длительность хранения доставленных сообщений в формате ДД.ЧЧ вы можете задать время, в течение которого будут храниться сообщения, доставленные в выбранный узел. Длительность задается в формате ДД:ЧЧ (например, 10:02 — 10 дней и 2 часа). Если указать длительность равную 00:00, то доставленные сообщения для данного узла не будут сохраняться в «1С:Шине».
Хранение доставленных сообщений может быть полезно в том случае, если есть риск, что после успешной отправки сообщения из «1С:Шины», на стороне получателя произойдет какой-либо сбой и полученные из «1С:Шины» сообщения будут удалены получателем либо обработаны с ошибкой. В таком случае, вы можете открыть список доставленных сообщений в карточке процесса интеграции и выгрузить либо отправить необходимые сообщения повторно. В этой главе будут подробно рассмотрены сценарии работы с доставленными сообщениями.
Список доставленных сообщений
Чтобы увидеть список доставленных сообщений, из пользовательского интерфейса «1С:Шины» откройте карточку процесс интеграции, после чего перейдите во вкладку Доставленные сообщения:
Вы увидите список доставленных сообщений. Список содержит следующие столбцы:
-
Идентификатор сообщения
Идентификатор доставленного сообщения
-
Имя узла
Имя узла, в котором сообщение было доставлено получателю
-
Участник
Имя участника процесса интеграции, которому было доставлено сообщение
-
Доставка
Д ата и время доставки сообщения в узел
-
Повторная доставка
Дата и время повторной доставки сообщения в узел
Иконка Скачать в правом нижнем углу экрана позволяет выгрузить все отобранные сообщения и их свойства (если условия отбора не заданы, будут выгружены все доставленные сообщения).
Отбор сообщений
Для того чтобы найти необходимые сообщения, вы можете использовать отбор:
- по узлу, в котором было доставлено сообщение;
- по участнику, которому было доставлено сообщение. Для этого следует указать код участника из справочника «Информационные системы»;
- по дате доставки. Вы можете указать диапазон дат, за который требуется найти доставленные сообщения.
Чтобы отобрать сообщения по необходимому условию, кликните иконку Отборы в правом верхнем углу списка, задайте условия поиска и нажмите Применить:
Будут отобраны все сообщения по заданным вами условиям. Вы можете выгрузить все отобранные сообщения. Для этого нажмите иконку Скачать в правом нижнем углу:
Вы увидите количество сообщений, которые будут скачаны и их общий вес. Для того чтобы скачивание началось, нажмите Подтвердить:
Просмотр информации о сообщении
Чтобы посмотреть более подробную информацию о сообщении, кликните на строку, содержащую нужное вам сообщение. Откроется карточка, в которой вы увидите параметры доставленного сообщения:
Выгрузка свойств и тела сообщения
Чтобы выгрузить свойства доставленного сообщения и его тело, нажмите на иконку загрузки в правом верхнем углу:
Вы также можете отобрать сразу несколько сообщений и выгрузить их за один раз. Отобрать сообщения для выгрузки можно в соответствии с одним из четырех условий:
- Раннее данного сообщения включая — будут отобраны все сообщения, предшествующие моменту доставки текущего сообщения, а также само текущее сообщение.
- Раннее данного сообщения не включая — будут отобраны все сообщения, предшествующие моменту доставки текущего сообщения, не включая текущее сообщение.
- Позднее данного сообщения включая — будут отобраны все сообщения, следующие за моментом доставки текущего сообщения, а также само текущее сообщение.
- Позднее данного сообщения не включая — будут отобраны все сообщения, следующие за моментом доставки текущего сообщения, не включая текущее сообщение.
Итак, для того чтобы выгрузить несколько сообщений за один раз, в правой области карточки выберите одно из четырех условий:
После чего нажмите Выгрузить и подтвердите выгрузку:
Будут выгружены все отобранные сообщения для конкретного узла и участника (при наличии). Выгрузка представляет из себя архив, в котором содержатся 2 файла:
-
body.bin
Файл, содержащий тело сообщения
-
metadata.json
Файл, содержащий информацию о свойствах сообщения в формате JSON