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