Синтаксис и применение НомерСообщения в платформе 1С:Предприятие. Описание и примеры кода.
Полное описание, параметры и ограничения
НомерСообщения (MessageNo)
НомерСообщения (MessageNo)
Тип: Число, Null.
Номер сообщения плана обмена.
Методическая информация
Практические примеры
Прочитать НомерСообщения в изменениях собственного Задача.УчебныеСогласования
Таблица изменений хранит регистрацию для узла, а не историю всех версий и не сами значения изменённых реквизитов.
Где и как запускать
Своя серверная процедура в отдельной учебной базе. Сначала первый подготовительный блок в той же процедуре, затем основной запрос; дополнительные обработчики размещаются отдельно по подписям.
Подготовка
Работайте в отдельной пустой учебной конфигурации. Создайте справочник УчебныеИсполнители и предопределённый элемент Демонстрационный с наименованием Учебный исполнитель.
Создайте задачу УчебныеСогласования: строковый номер длиной 12, автонумерация, наименование длиной 100. Добавьте реквизит адресации Исполнитель типа СправочникСсылка.УчебныеИсполнители и выберите его основным реквизитом адресации. Здесь используется прямая адресация; регистр ролевой адресации не нужен.
Создайте параметр сеанса УчебныйИсполнитель того же ссылочного типа. В свойстве задачи Текущий исполнитель выберите этот параметр. Запросы урока передают исполнителя явно и не зависят от начального значения параметра сеанса.
Создайте бизнес-процесс УчебноеСогласование со строковым номером длиной 12 и автонумерацией. В свойстве Задача выберите УчебныеСогласования. Карта маршрута: Старт (начало) → Согласовать (действие) → Завершение. В точке Согласовать задайте адресацию Исполнитель = Демонстрационный, Групповая = Ложь.
И у задачи, и у бизнес-процесса создайте обычные реквизиты КомментарийУчебный (Строка 100), Сумма (Число 12.2), Подтверждено (Булево), ЗапретУдаления (Булево). Добавьте табличную часть Детали с колонками Наименование (Строка 100) и Количество (Число 10.0).
Создайте общий реквизит УчебныйИсточник типа Строка 20, Разделение данных = Не использовать. Включите только учебную задачу и бизнес-процесс в его состав. Это не разделитель и не настройка рабочей конфигурации.
В модуле объекта бизнес-процесса разместите отдельный обработчик СогласоватьПриСозданииЗадач из дополнительного блока. В свойствах точки Согласовать назначьте его событию ПриСозданииЗадач. Платформа записывает сформированные задачи после обработчика; внутри него Записать не вызывается.
Функцию ПодготовитьУчебныйПроцесс разместите в том же собственном серверном общем модуле, что и процедуру примера. Её вызов действительно создаёт новый процесс и его задачу; это не строковая подстановка имени.
В этом уроке запрос относится только к таблице изменений выбранного типа. Маршрут не завершается, задачи не выполняются и ничего не отправляется.
Создайте отдельный план обмена УчебныйОбменИзменений: строковый код 10 без маски, наименование 100, Распределённая информационная база = Ложь. В состав включите именно Задача.УчебныеСогласования; для перерасчёта выберите соответствующий регистр расчёта с его перерасчётом.
У участвующего объекта в составе плана отключите автоматическую регистрацию: изменения регистрирует показанный код явно. Передачи данных, записи сообщения обмена, транспорта и синхронизации в примере нет.
Обновите только свою пустую учебную базу. Код — собственный серверный общий модуль: основной блок и первый подготовительный блок исполняются подряд в одной процедуре, сначала подготовительный, затем основной.
Новый узел создаётся при каждом запуске, а запрос ограничен его ссылкой. ЗарегистрироватьИзменения получает конкретные Данные, не объект метаданных и не пропущенный аргумент: массовая регистрация всех данных не выполняется.
Запрос = Новый Запрос;
Запрос.Текст = "ВЫБРАТЬ
| Изменения.Узел КАК Узел,
| Изменения.НомерСообщения КАК НомерСообщения,
| Изменения.Ссылка КАК Ссылка
|ИЗ Задача.УчебныеСогласования.Изменения КАК Изменения
|ГДЕ Изменения.Узел = &Узел";
Запрос.УстановитьПараметр("Узел", Узел.Ссылка);
Выборка = Запрос.Выполнить().Выбрать();
Пока Выборка.Следующий() Цикл
Сообщить("Узел: " + Строка(Выборка.Узел));
Сообщить("НомерСообщения: " + Строка(Выборка.НомерСообщения));
Сообщить("Ссылка: " + Строка(Выборка.Ссылка));
КонецЦикла;Перед основным запросом в той же серверной процедуре: свой узел, данные и конкретная регистрация
Узел = ПланыОбмена.УчебныйОбменИзменений.СоздатьУзел();
Узел.Код = Лев(Строка(Новый УникальныйИдентификатор), 10);
Узел.Наименование = "Свой учебный приемник";
Узел.Записать();
СвоиОбъекты = ПодготовитьУчебныйПроцесс();
Данные = СвоиОбъекты.Задача;
ПланыОбмена.ЗарегистрироватьИзменения(Узел.Ссылка, Данные);
Сообщить("Изменение зарегистрировано только для своего нового узла");Тот же серверный общий модуль: реальный процесс и задача
Функция ПодготовитьУчебныйПроцесс(ЗапуститьМаршрут = Истина) Экспорт
Процесс = БизнесПроцессы.УчебноеСогласование.СоздатьБизнесПроцесс();
Процесс.Дата = Дата(2026, 10, 14, 10, 0, 0);
Процесс.КомментарийУчебный = "Согласовать учебную покупку";
Процесс.Сумма = 100;
Процесс.Подтверждено = Ложь;
Процесс.УчебныйИсточник = "ПРИМЕР";
Деталь = Процесс.Детали.Добавить();
Деталь.Наименование = "Книга";
Деталь.Количество = 2;
Процесс.Записать();
Если Не ЗапуститьМаршрут Тогда
Возврат Новый Структура("Процесс,Задача", Процесс.Ссылка, Задачи.УчебныеСогласования.ПустаяСсылка());
КонецЕсли;
Процесс.Старт();
Запрос = Новый Запрос;
Запрос.Текст = "ВЫБРАТЬ Ссылка ИЗ Задача.УчебныеСогласования ГДЕ БизнесПроцесс = &Процесс";
Запрос.УстановитьПараметр("Процесс", Процесс.Ссылка);
Выборка = Запрос.Выполнить().Выбрать();
Если Не Выборка.Следующий() Тогда
ВызватьИсключение "Маршрут не создал учебную задачу: проверьте подготовку";
КонецЕсли;
Возврат Новый Структура("Процесс,Задача", Процесс.Ссылка, Выборка.Ссылка);
КонецФункцииМодуль своего бизнес-процесса: назначить точке Согласовать событие ПриСозданииЗадач
Процедура СогласоватьПриСозданииЗадач(ТочкаМаршрута, ФормируемыеЗадачи, Отказ)
Для Каждого НоваяЗадача Из ФормируемыеЗадачи Цикл
НоваяЗадача.КомментарийУчебный = "Проверить учебную покупку";
НоваяЗадача.Сумма = 100;
НоваяЗадача.УчебныйИсточник = "ПРИМЕР";
Деталь = НоваяЗадача.Детали.Добавить();
Деталь.Наименование = "Книга";
Деталь.Количество = 2;
КонецЦикла;
КонецПроцедурыРазбор по шагам
Подготовка создаёт конкретный собственный новый узел и реальные данные указанного вида.
ЗарегистрироватьИзменения вызывается для ссылки этого узла и конкретного объекта / набора, не для всей метадаты.
Запрос выбирает зарегистрированный ключ по своему узлу; Следующий вызывается до чтения полей.
Как проверить результат
Получены поля только своего нового узла. Для ещё не включённых в сообщение изменений НомерСообщения может быть Null; не выдавайте его за готовый номер отправленного сообщения.
Ссылка / Регистратор / ОбъектПерерасчета относятся к реально созданным собственным данным. Запрос не открывает транспорт и не подтверждает доставку.
Наличие записи регистрации не означает, что изменился рабочий товар или состоялась синхронизация; источник создаёт только собственные метаданные / данные.
Ожидаемый результат
Настоящая регистрация конкретных собственных данных прочитана из таблицы изменений с правильным для её вида ключом.
На что обратить внимание
Не пропускайте второй аргумент ЗарегистрироватьИзменения и не передавайте Метаданные целого объекта: это зарегистрирует все соответствующие данные.
У независимого и подчинённого регистра сведений разные ключи таблицы изменений. Для неразделяющего общего реквизита такое поле таблицы изменений не появляется.
Ничего не передаётся по сети; BSL, запись узлов и регистрация изменений при сборке HTML не выполнялись.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.