Обращение к дополнительному реквизиту справочника в 1С: полное руководство с примерами

Работа с дополнительными реквизитами в 1С:Предприятие — одна из самых востребованных задач среди разработчиков. Эти гибкие поля позволяют расширять стандартные справочники без модификации конфигурации, но их программное использование часто вызывает вопросы. Почему при обращении к такому реквизиту возвращается Неопределено? Как правильно составить запрос с учетом динамических свойств? И почему значения дополнительных реквизитов иногда "теряются" при обмене данными?

В этой статье мы разберем три основных способа доступа к дополнительным реквизитам — через объектную модель, встроенный язык и запросы — с акцентом на нюансы, которые не описаны в официальной документации. Вы узнаете, как избежать типичных ошибок при работе с ЗначениеДополнительныхРеквизитов, почему не стоит использовать Получить() для динамических свойств, и как правильно организовать код для поддержки версионности конфигураций от 1С:Предприятие 8.2 до 8.3.22.

1. Структура дополнительных реквизитов в 1С: что нужно знать перед обращением

Прежде чем писать код, важно понять, как 1С:Предприятие хранит дополнительные реквизиты на уровне платформы. В отличие от стандартных реквизитов, которые являются частью метаданных объекта, дополнительные реквизиты представляют собой динамические свойства, привязанные к объекту через механизм ЗначениеДополнительныхРеквизитов.

Эта особенность влечет несколько ключевых последствий:

• 🔹 Дополнительные реквизиты не видны в списке свойств объекта через точку (например, Справочник.НовыйРеквизит вызовет ошибку).
• 🔹 Их значения хранятся в отдельной таблице базы данных (_InfoRg{ID} для регистров сведений).
• 🔹 При обмене данными через XML или JSON дополнительные реквизиты могут требовать явного указания в правилах обмена.
• 🔹 В запросах к ним нужно обращаться через виртуальную таблицу ДополнительныеРеквизитыИЗначения.

Важно: дополнительные реквизиты могут быть глобальными (применяются ко всем объектам конфигурации) или локальными (только для конкретного справочника). Это влияет на синтаксис обращения к ним. Например, для глобального реквизита "Цвет" путь будет отличаться от локального реквизита "Справочник.Номенклатура.Цвет".

2. Способ 1: Обращение через объектную модель (самый простой метод)

Самый интуитивно понятный способ — использование коллекции ЗначениеДополнительныхРеквизитов, которая доступна у любого объекта справочника. Этот метод подходит для 1С 8.3 и более ранних версий (начиная с 8.2.14).

Пример кода для получения значения дополнительного реквизита "Вес" у элемента справочника "Номенклатура":

СсылкаНаНоменклатуру = Справочники.Номенклатура.НайтиПоНаименованию("Стул офисный");
ОбъектНоменклатуры = СсылкаНаНоменклатуру.ПолучитьОбъект();

// Получение значения дополнительного реквизита
ЗначениеВеса = ОбъектНоменклатуры.ЗначениеДополнительныхРеквизитов["Вес"];

// Альтернативный вариант (если реквизит локальный для справочника)
ЗначениеВеса = ОбъектНоменклатуры.ЗначениеДополнительныхРеквизитов.Номенклатура.Вес;

Обратите внимание на два ключевых момента:

1. Мы используем объект справочника (.ПолучитьОбъект()), а не ссылку. Коллекция ЗначениеДополнительныхРеквизитов доступна только у объекта.
2. Для локальных реквизитов путь включает имя справочника (.Номенклатура.Вес), для глобальных — только имя реквизита (["Вес"]).

Если ЗначениеЗаполнено(Объект.ЗначениеДополнительныхРеквизитов["НесуществующийРеквизит"]) Тогда
// Реквизит существует
Иначе
// Реквизит не найден
КонецЕсли;

Типичная ошибка: многие разработчики пытаются использовать метод .Получить("ИмяРеквизита") для дополнительных реквизитов. Это не сработает — метод Получить() предназначен только для стандартных реквизитов объекта. Для динамических свойств нужно использовать исключительно коллекцию ЗначениеДополнительныхРеквизитов.

1. Убедиться, что реквизит существует в настройках справочника|false

2. Проверить права доступа текущего пользователя к динамическим свойствам|false

3. Использовать объект справочника, а не ссылку|false

4. Учесть локальность/глобальность реквизита при обращении|false-->

3. Способ 2: Работа через встроенный язык (универсальный подход)

Для более гибкой работы с дополнительными реквизитами (например, когда нужно динамически формировать имя реквизита или работать с массивом объектов) удобно использовать функции встроенного языка: ПолучитьДополнительныеРеквизиты() и УстановитьДополнительныеРеквизиты().

Пример получения всех дополнительных реквизитов элемента справочника:

СсылкаНаЭлемент = Справочники.Контрагенты.НайтиПоНаименованию("ООО Ромашка");
ДопРеквизиты = ПолучитьДополнительныеРеквизиты(СсылкаНаЭлемент);

// Перебор всех дополнительных реквизитов
Для Каждого ИмяРеквизита Из ДопРеквизиты.Ключи() Цикл
Сообщить(СтрШаблон("Реквизит %1 = %2", ИмяРеквизита, ДопРеквизиты[ИмяРеквизита]));
КонецЦикла;

Преимущества этого метода:

• 🔧 Работает как со ссылками, так и с объектами.
• 🔄 Позволяет получить все дополнительные реквизиты сразу (в виде структуры).
• 📝 Поддерживает массовое изменение реквизитов через УстановитьДополнительныеРеквизиты().

Для установки значения используется аналогичная функция:

НовыеДопРеквизиты = Новый Структура("Вес, Цвет", 15.5, "Красный");
УстановитьДополнительныеРеквизиты(СсылкаНаЭлемент, НовыеДопРеквизиты);

Важный нюанс: функции ПолучитьДополнительныеРеквизиты() и УстановитьДополнительныеРеквизиты() работают медленнее, чем прямое обращение через коллекцию, если вам нужно получить только 1-2 реквизита. Используйте их только когда требуется массовая обработка.

⚠️ Внимание: В конфигурациях с включенным режимом "Управляемое приложение" (например, 1С:ERP или 1С:УТ 11) функции встроенного языка могут требовать явного указания параметра Истина для работы с динамическими свойствами:

ДопРеквизиты = ПолучитьДополнительныеРеквизиты(Ссылка, Истина);

4. Способ 3: Использование запросов (для отчетов и сложной выборки)

Когда нужно получить дополнительные реквизиты в отчетах или сделать сложную выборку по нескольким объектам, удобнее использовать язык запросов. Для этого в 1С предусмотрена виртуальная таблица ДополнительныеРеквизитыИЗначения.

Базовый синтаксис запроса:

Выборка = Новый Запрос;
Выборка.Текст =
"ВЫБРАТЬ
|   Номенклатура.Ссылка КАК Ссылка,
|   Номенклатура.Наименование КАК Наименование,
|   ДопРеквизиты.Значение КАК Вес
|ИЗ
|   Справочник.Номенклатура КАК Номенклатура
|       ЛЕВОЕ СОЕДИНЕНИЕ ДополнительныеРеквизитыИЗначения.СрезПоследних КАК ДопРеквизиты
|       ПО Номенклатура.Ссылка = ДопРеквизиты.Объект
|           И ДопРеквизиты.Реквизит = &Реквизит
|ГДЕ
|   Номенклатура.ЭтоГруппа = ЛОЖЬ";

Выборка.УстановитьПараметр("Реквизит", Справочники.ДополнительныеРеквизитыИЗначения.НайтиПоНаименованию("Вес"));
Результат = Выборка.Выполнить();

Ключевые моменты при работе с запросами:

Для выборки всех дополнительных реквизитов за один запрос используйте конструкцию:

"ВЫБРАТЬ РАЗЛИЧНЫЕ
|   ДопРеквизиты.Реквизит КАК Реквизит,
|   ДопРеквизиты.Значение КАК Значение
|ИЗ
|   ДополнительныеРеквизитыИЗначения.СрезПоследних КАК ДопРеквизиты
|ГДЕ
|   ДопРеквизиты.Объект = &Объект"

⚠️ Внимание: В запросах к ДополнительныеРеквизитыИЗначения всегда используйте СрезПоследних, иначе вы получите историю изменений реквизитов вместо актуальных значений. Это особенно важно для конфигураций с включенной поддержкой версий данных (например, 1С:Бухгалтерия 3.0).

5. Типичные ошибки и как их избежать

Даже опытные разработчики 1С сталкиваются с проблемами при работе с дополнительными реквизитами. Вот самые распространенные ошибки и способы их решения:

Ошибка 1: "Неопределено" вместо значения реквизита

• 🔍 Причина: Обращение к реквизиту через точку (Объект.Вес) вместо коллекции ЗначениеДополнительныхРеквизитов.
• ✅ Решение: Используйте Объект.ЗначениеДополнительныхРеквизитов["Вес"].

Ошибка 2: Ошибка при записи значения ("Поле объекта не обнаружено")

• 🔍 Причина: Попытка установить значение через Объект.Вес = 10 вместо Объект.ЗначениеДополнительныхРеквизитов["Вес"] = 10.
• ✅ Решение: Всегда используйте коллекцию ЗначениеДополнительныхРеквизитов для записи.

Ошибка 3: Запрос возвращает пустой результат

• 🔍 Причина 1: Не указан параметр ДопРеквизиты.Реквизит = &Реквизит в условии соединения.
• 🔍 Причина 2: Используется неверная виртуальная таблица (например, ДополнительныеРеквизиты вместо ДополнительныеРеквизитыИЗначения.СрезПоследних).
• ✅ Решение: Проверьте структуру запроса по примеру из раздела 4.

Ошибка 4: Значения реквизитов не сохраняются при записи объекта

• 🔍 Причина: Изменения вносятся в объект, но не вызывается метод .Записать().
• ✅ Решение: После изменения дополнительных реквизитов обязательно сохраните объект:

  Объект.ЗначениеДополнительныхРеквизитов["Вес"] = 20;
  Объект.Записать();

6. Работа с дополнительными реквизитами в типовой конфигурации (1С:ERP, 1С:УТ, 1С:БП)

В типовой конфигурации 1С:ERP Управление предприятием 2.5 и аналогичных решениях (1С:УТ 11, 1С:БП 3.0) дополнительные реквизиты часто используются для расширения функциональности без модификации. Однако здесь есть свои нюансы:

Особенность 1: Права доступа

В ERP-системах доступ к дополнительным реквизитам контролируется на уровне ролей. Если ваш код возвращает пустые значения, проверьте:

• 🔐 Наличие права "Чтение дополнительных реквизитов" у текущего пользователя.
• 🔐 Права на конкретный справочник (например, "Номенклатура: Чтение").

Особенность 2: Обмен данными

При настройке обмена через Универсальный формат (EnterpriseData) дополнительные реквизиты нужно явно включать в правила обмена. В противном случае их значения не будут передаваться между базами.

// Пример настройки правила обмена для дополнительного реквизита
ПравилоОбмена.ДобавитьРеквизит("ДополнительныеРеквизиты",
Новый ПравилоОбменаДаннымиДополнительныеРеквизиты(Истина));

Особенность 3: Версионность данных

В конфигурациях с поддержкой версий (например, 1С:БП 3.0) дополнительные реквизиты могут иметь историю изменений. Для получения актуального значения всегда используйте:

Запрос.Текст = "ВЫБРАТЬ
|   ДопРеквизиты.Значение КАК Вес
|ИЗ
|   ДополнительныеРеквизитыИЗначения.СрезПоследних КАК ДопРеквизиты
|ГДЕ
|   ДопРеквизиты.Объект = &Объект";

⚠️ Внимание: В типовой конфигурации 1С:ERP 2.5 дополнительные реквизиты для справочника "Номенклатура" могут иметь префикс "Характеристики" (например, "Характеристики.Вес"). Уточните точные имена реквизитов в настройках системы.

7. Оптимизация производительности при работе с дополнительными реквизитами

Дополнительные реквизиты хранятся в отдельных таблицах базы данных, поэтому их массовая обработка может замедлять работу системы. Вот несколько советов для оптимизации:

Совет 1: Кэширование значений

Если вам нужно многократно обращаться к одним и тем же реквизитам, закэшируйте их значения в памяти:

Процедура ПолучитьДопРеквизиты(СсылкаНаОбъект)
Статический КэшДопРеквизитов = Новый Соответствие;

Если НЕ КэшДопРеквизитов.Содержит(СсылкаНаОбъект) Тогда
КэшДопРеквизитов.Вставить(СсылкаНаОбъект, ПолучитьДополнительныеРеквизиты(СсылкаНаОбъект));
КонецЕсли;

Возврат КэшДопРеквизитов[СсылкаНаОбъект];
КонецПроцедуры

Совет 2: Массовое чтение через запросы

Если нужно получить дополнительные реквизиты для большого количества объектов, используйте один запрос вместо цикла:

Запрос.Текст = "ВЫБРАТЬ
|   Номенклатура.Ссылка КАК Ссылка,
|   ДопРеквизиты.Значение КАК Вес
|ИЗ
|   Справочник.Номенклатура КАК Номенклатура
|       ЛЕВОЕ СОЕДИНЕНИЕ ДополнительныеРеквизитыИЗначения.СрезПоследних КАК ДопРеквизиты
|       ПО Номенклатура.Ссылка = ДопРеквизиты.Объект
|           И ДопРеквизиты.Реквизит = &Реквизит
|ГДЕ
|   Номенклатура.Ссылка В (&СписокСсылок)";

Совет 3: Избегайте лишних записей

При массовом изменении дополнительных реквизитов используйте УстановитьДополнительныеРеквизиты() с передачей структуры всех изменяемых реквизитов за один вызов:

НовыеЗначения = Новый Структура;
НовыеЗначения.Вставить("Вес", 25);
НовыеЗначения.Вставить("Цвет", "Синий");

УстановитьДополнительныеРеквизиты(СписокСсылок, НовыеЗначения);

Совет 4: Отключайте проверку прав (осторожно!)

В критичных по производительности местах (например, при загрузке данных) можно временно отключить проверку прав доступа:

ПроверкаПрав = Ложь;
ПолучитьДополнительныеРеквизиты(Ссылка, , ПроверкаПрав);

⚠️ Используйте этот прием только в доверенной среде, так как он обходит систему безопасности 1С.

FAQ: Частые вопросы по работе с дополнительными реквизитами

Если Метаданные.ДополнительныеРеквизитыИЗначения.НайтиПоНаименованию("Вес") <> Неопределено Тогда
// Реквизит существует
КонецЕсли;

Если Объект.ЗначениеДополнительныхРеквизитов.Свойство("Вес") Тогда
Значение = Объект.ЗначениеДополнительныхРеквизитов.Вес;
КонецЕсли;

НовыйРеквизит = Метаданные.ДополнительныеРеквизитыИЗначения.СоздатьРеквизит();
НовыйРеквизит.Наименование = "НовыйРеквизит";
НовыйРеквизит.ТипЗначения = Новый Тип("Строка");
НовыйРеквизит.Применение.Добавить(Новый ОписаниеТипов("СправочникСсылка.Номенклатура"));
НовыйРеквизит.Записать();

Запрос.Текст = "ВЫБРАТЬ
|   ДопРеквизиты.Период КАК ДатаИзменения,
|   ДопРеквизиты.Значение КАК Значение
|ИЗ
|   ДополнительныеРеквизитыИЗначения КАК ДопРеквизиты
|ГДЕ
|   ДопРеквизиты.Объект = &Объект
|   И ДопРеквизиты.Реквизит = &Реквизит
|УПОРЯДОЧИТЬ ПО
|   ДопРеквизиты.Период УБЫВ";