Как получить значение дополнительного реквизита в 1С 8.3 программно

В процессе разработки конфигураций на платформе 1С:Предприятие 8.3 программисты часто сталкиваются с необходимостью динамически работать с данными, структура которых не была жестко зафиксирована на этапе проектирования. Механизм дополнительных реквизитов и сведений позволяет пользователям гибко расширять справочники и документы, добавляя поля «на лету». Однако для разработчика это создает определенную сложность: как получить значение дополнительного реквизита в 1С 8.3 программно, когда имя поля может быть неизвестно заранее или изменяться в зависимости от настроек?

Решение этой задачи требует глубокого понимания архитектуры метаданных и работы с объектами типа ДополнительныеРеквизитыСведенияМенеджер. Ошибки при обращении к таким полям часто приводят к исключениям времени выполнения, особенно если тип хранимого значения отличается от ожидаемого или если сам реквизит был удален из конфигурации. В этой статье мы разберем все тонкости доступа к этим данным, от простых методов до сложных случаев с составными типами.

Важно понимать, что дополнительные реквизиты хранятся не как обычные поля объекта, а в специальной коллекции. Прямое обращение к ним через точку, как к обычным свойствам, возможно только в том случае, если вы работаете с объектом в режиме предприятия и имя реквизита жестко задано. В коде же, особенно в общих модулях, требуется использование специализированных методов менеджера дополнительных сведений.

Архитектура хранения дополнительных сведений в объектах

Каждый объект конфигурации, поддерживающий дополнительные реквизиты (справочники, документы, планы счетов), имеет встроенное свойство ДополнительныеРеквизиты. Это свойство представляет собой коллекцию значений, где каждое значение описывает конкретный дополнительный параметр. Внутри этой коллекции хранятся не сами данные, а ссылки на объекты метаданных и фактические значения.

Для программного доступа используется менеджер ДополнительныеРеквизитыСведенияМенеджер, который предоставляет методы для чтения, записи и поиска нужных полей. Ключевой особенностью является то, что имя дополнительного реквизита в коде часто не совпадает с его синонимом, видимым пользователю в интерфейсе. Поэтому надежнее всего обращаться к реквизитам по их уникальному идентификатору или имени в базе метаданных.

Существует несколько способов получения значения, выбор которых зависит от контекста задачи. Если вы точно знаете имя реквизита, можно использовать метод ПолучитьЗначениеРеквизита. Если же имя динамически формируется или выбирается пользователем, потребуется предварительный поиск описания реквизита в коллекции перед извлечением данных.

💡

Всегда проверяйте существование дополнительного реквизита перед попыткой чтения его значения, чтобы избежать ошибок выполнения в продакшн-среде.

Базовый алгоритм чтения значения по имени реквизита

Самый распространенный сценарий — получение значения, когда имя дополнительного реквизита известно разработчику. В этом случае алгоритм сводится к получению ссылки на объект и вызову метода менеджера. Рассмотрим пример для элемента справочника Номенклатура.

Сначала необходимо получить объект в память или использовать ссылку. Затем через свойство ДополнительныеРеквизиты мы обращаемся к менеджеру.

СсылкаНаОбъект = Справочники.Номенклатура.НайтиПоНаименованию("Товар А");
Если СсылкаНаОбъект.Пустая Тогда
Возврат Неопределено;
КонецЕсли;

// Получаем значение дополнительного реквизита"Цвет"
ЗначениеРеквизита = СсылкаНаОбъект.ДополнительныеРеквизиты.ПолучитьЗначениеРеквизита("Цвет");

В данном примере строка "Цвет" соответствует имени реквизита в базе метаданных. Если в конфигурации используется префикс или имя было изменено при обновлении, код может выдать ошибку. Поэтому в надежных системах имена дополнительных реквизитов часто выносят в константы или общие модули.

☑️ Проверка перед чтением реквизита

Убедиться, что объект не пустойПроверить существование реквизита в справочнике дополнительных сведенийУбедиться, что тип значения соответствует ожидаемомуОбработать возможное исключение при чтении

Выполнено: 0 / 4

⚠️ Внимание: Метод ПолучитьЗначениеРеквизита вернет Неопределено, если реквизит с таким именем не найден, но не вызовет критическую ошибку. Однако попытка вызвать методы у полученного значения без проверки может привести к падению кода.

Работа с динамическими именами и поиск по описанию

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

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

Пример кода для поиска реквизита по синониму"Артикул поставщика":

Функция ПолучитьЗначениеПоСинониму(Объект, СинонимРеквизита)

ОписаниеРеквизита = Неопределено;

// Перебираем все дополнительные реквизиты объекта
Для каждого ДопРекв Из Объект.ДополнительныеРеквизиты Цикл
Если ДопРекв.Синоним = СинонимРеквизита Тогда
ОписаниеРеквизита = ДопРекв;
Прервать;
КонецЕсли;
КонецЦикла;

Если ОписаниеРеквизита = Неопределено Тогда
Возврат Неопределено;
КонецЕсли;

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

КонецФункции

Такой подход позволяет гибко реагировать на изменения в интерфейсе пользователя, когда синонимы могут быть переименованы, но логика работы программы должна сохраняться. Однако перебор коллекции может быть менее производителен на больших объемах данных, поэтому кэширование имен реквизитов является хорошей практикой.

Обработка составных типов и приведение данных

Одной из главных особенностей дополнительных реквизитов является возможность хранения данных составных типов. Поле может содержать строку, число, дату, ссылку на объект или даже булево значение. При программном получении значения вы часто получаете вариант типа ЛюбаяСсылка, Строка или Число.

Для корректной работы с полученными данными необходимо выполнять проверку типа. Использование оператора ТипЗнч или конструкции Тип позволяет определить, что именно вернул метод чтения. Без этой проверки попытки выполнить арифметические операции со строкой или вызвать методы объекта у простого типа приведут к ошибке.

Рассмотрим таблицуных типов данных, которые могут храниться в дополнительных реквизитах, и способы их обработки:

Тип данных в 1С	Пример значения	Особенности обработки
`Строка`	"Красный"	Требует проверки на пустую строку
`Число`	1500.50	Возможна потеря точности при конвертации
`Дата`	01.01.2026	Может быть неопределенной датой
`СправочникСсылка`	Ссылка на контрагента	Необходима проверка на пустую ссылку
`Булево`	Истина	Строгая типизация, нет приведения

При работе со ссылками на объекты В этом случае попытка прочитать свойства этого объекта вызовет ошибку. Всегда используйте проверку Пустая для ссылок, полученных из дополнительных реквизитов.

Что делать, если тип реквизита изменился?

Если в процессе эксплуатации тип дополнительного реквизита изменился (например, со Строки на Число), старые данные могут стать нечитаемыми. Необходимо писать код миграции или предусматривать обработку исключений при чтении.

Особенности работы в управляемых формах и серверном коде

При разработке в управляемом приложении важно различать контекст выполнения кода. Дополнительные реквизиты могут читаться как на клиенте, так и на сервере, но есть нюансы. На клиенте доступ к полным данным объекта может быть ограничен правами доступа или тем, что объект еще не полностью загружен из базы.

Если вы работаете с формой элемента, свойство Объект формы содержит данные в памяти. Чтение дополнительных реквизитов из Объект.ДополнительныеРеквизиты происходит мгновенно, без обращения к базе данных. Однако, если реквизит был добавлен недавно и форма не была перезапущена, его может не быть в текущей структуре объекта формы.

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

⚠️ Внимание: При чтении дополнительных реквизитов на сервере в цикле по большой выборке избегайте получения полного объекта (ПолучитьОбъект) для каждой строки. Это значительно замедляет работу. Используйте запросы к регистру сведений или виртуальной таблице дополнительных реквизитов.

Для оптимизации производительности можно использовать запрос к виртуальной таблице ДополнительныеРеквизиты.СрезПоследних. Это позволяет получить значения сразу для множества объектов одним обращением к базе данных, что критично для отчетов и обработок больших объемов данных.

💡

Использование виртуальных таблиц дополнительных реквизитов в запросах повышает производительность в десятки раз по сравнению с пообъектным чтением в цикле.

Типичные ошибки и методы отладки

Наиболее частой ошибкой при работе с дополнительными реквизитами является неверное указание имени. Разработчики часто путают Синоним, Имя и Представление реквизита. В коде необходимо использовать именно Имя, которое видно в конфигураторе в списке дополнительных реквизитов.

Еще одна проблема — попытка записать значение неправильного типа. Платформа 1С строго контролирует типы данных в дополнительных реквизитах, если они настроены. Попытка записать строку в реквизит типа"Число" вызовет исключение. Для диагностики таких проблем удобно использовать консоль кода или режим отладки с точками останова на строках получения значения.

Также стоит учитывать права доступа. Если у пользователя нет прав на чтение определенного дополнительного реквизита (например, он помечен как конфиденциальный), метод вернет пустое значение или вызовет ошибку прав, в зависимости от настроек конфигурации. Всегда тестируйте код под пользователем с ограниченными правами.

Для быстрой проверки существования реквизита и его типа можно использовать следующий сниппет для отладки:

Попытка
Значение = Объект.ДополнительныеРеквизиты.ПолучитьЗначениеРеквизита("ИмяРеквизита");
Сообщить("Тип:" + ТипЗнч(Значение) +", Значение:" + Значение);
Исключение
Сообщить("Ошибка чтения:" + ОписаниеОшибки);
КонецПопытки;

⚠️ Внимание: Интерфейс и возможности работы с дополнительными реквизитами могут незначительно отличаться в различных версиях платформы 1С (8.3.10, 8.3.20 и новее). Всегда сверяйте синтаксис методов в справке по вашей конкретной версии платформы.

FAQ: Часто задаваемые вопросы

Можно ли получить значение дополнительного реквизита через запрос?

Да, это возможно и даже рекомендуется для выборок. Используйте виртуальную таблицу ДополнительныеРеквизитыСрезПоследних в тексте запроса. Это позволяет получить значения дополнительных полей вместе с основными данными объекта без лишних обращений к базе.

Что вернет метод, если реквизит не заполнен?

Если дополнительный реквизит существует в структуре объекта, но не заполнен (пустой), метод ПолучитьЗначениеРеквизита вернет значение вида Неопределено или пустое значение соответствующего типа (пустая строка, ноль), в зависимости от настроек типа данных реквизита.

Как узнать имя дополнительного реквизита программно?

Вы можете перебрать коллекцию Объект.ДополнительныеРеквизиты в цикле. У каждого элемента коллекции есть свойства Имя, Синоним и ТипЗначения, которые позволяют идентифицировать нужный реквизит.

Влияют ли дополнительные реквизиты на производительность базы?

При грамотном использовании — минимально. Однако хранение больших объемов данных в дополнительных реквизитах типа"Длинная строка" или частое использование их в отборах запросов без индексации может замедлить работу системы. Для часто используемых полей лучше создавать обычные реквизиты.

Можно ли изменить значение дополнительного реквизита в режиме предприятия?

Да, если у пользователя есть соответствующие права. Программно это делается через метод УстановитьЗначениеРеквизита менеджера дополнительных сведений. После изменения необходимо вызвать метод Записать для самого объекта, чтобы сохранить изменения в базу.

Программное получение значения дополнительного реквизита в 1С 8.3