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