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

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

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

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

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

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

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

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

⚠️ Внимание: Структура таблиц хранения дополнительных сведений может отличаться в разных конфигурациях (БП, УТ, ЗУП). Всегда проверяйте имя регистра сведений в вашей конкретной базе перед написанием жестко закодированных запросов.

Чтение значений через встроенные методы объекта

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

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

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

Элемент = Справочники.Номенклатура.ПолучитьСсылка(УникальныйИдентификатор);
ДопРеквизиты = Элемент.ПолучитьДополнительныеРеквизиты;
ЗначениеАтрибута = ДопРеквизиты.Получить("ЦветКорпуса");

Использование встроенных методов также позволяет легко записывать изменения обратно. Вам не нужно вручную формировать движения по регистрам. Достаточно установить новое значение в коллекцию и вызвать метод записи. Это значительно упрощает поддержку кода и снижает вероятность ошибок при модификации данных.

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

Когда требуется получить значения дополнительных реквизитов для большого списка объектов, обращение к каждому объекту индивидуально через методы станет «узким горлышком» производительности. В таких случаях единственно верным решением является использование языка запросов 1С. Это позволяет выбрать данные одним обращением к СУБД.

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

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

Параметр запроса	Описание	Пример значения
Измерение	Ссылка на основной объект	Ссылка
Ресурс	Хранимое значение атрибута	Значение
Ресурс	Наименование свойства	Свойство
Ресурс	Тип значения	ТипЗначения

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

Оптимизация запросов с доп. реквизитами

Если вы выбираете данные для отчета, старайтесь фильтровать регистр дополнительных реквизитов сразу в тексте запроса по полю"Свойство". Это уменьшит объем передаваемых данных из базы и ускорит работу отчета в разы по сравнению с фильтрацией в коде 1С.

Работа с дополнительными реквизитами в СКД

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

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

Однако стоит быть осторожным с производительностью. Если отчет выводит десятки дополнительных реквизитов для тысяч строк, время формирования может возрасти. В таких случаях рекомендуется использовать параметрические запросы или предварительно отбирать только те реквизиты, которые действительно нужны пользователю в данном конкретном отчете.

⚠️ Внимание: При использовании СКД убедитесь, что типы данных дополнительных реквизитов совместимы с типами полей, куда они выводятся. Неявное преобразование типов (например, строки в число) может привести к ошибкам при формировании отчета.

Обработка отсутствующих значений и типов

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

Всегда проверяйте значение на пустоту перед использованием. В 1С для этого удобно использовать функцию ЗначениеЗаполнено или явное сравнение с Неопределено. Кроме того, если вы планируете выполнять арифметические операции, убедитесь, что retrieved значение действительно является числом, а не строкой, содержащей текст.

Для безопасной работы рекомендуется оборачивать критические участки кода в попытки обработки исключений или использовать строгую проверку типов перед приведением. Это особенно актуально, если данные вводились вручную и могли содержать опечатки или некорректные форматы.

Если ТипЗнч(ЗначениеАтрибута) = Тип("Число") Тогда
Сумма = Сумма + ЗначениеАтрибута;
Иначе
Сообщить("Ошибка типа данных в реквизите");
КонецЕсли;

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

Производительность и лучшие практики

При масштабировании системы вопросы производительности выходят на первый план. Чтение дополнительных реквизитов в цикле для каждого документа или элемента справочника — это классическая ошибка, которая тормозит работу базы. Каждое такое обращение — это отдельный запрос к серверу или даже к диску.

Золотое правило: выбирайте данные пакетами. Если вам нужно обработать 1000 документов, сформируйте один запрос, который вернет таблицу со всеми необходимыми дополнительными реквизитами сразу. Затем в коде 1С найдите нужное значение в этой таблице по ссылке. Это снизит нагрузку на СУБД в сотни раз.

Еще один важный аспект — индексация. Убедитесь, что в регистре сведений, хранящем дополнительные реквизиты, настроены правильные индексы по полям, которые часто используются в условиях отбора (например, по Свойству или Ссылке). Это ускорит выполнение запросов, особенно в больших базах данных.

• 🚀 Используйте пакетную выборку данных вместо циклического обращения к объектам.
• 📊 Проверяйте наличие индексов в регистре дополнительных сведений для полей частого поиска.
• 🛡️ Кэшируйте часто используемые значения в памяти, если они не меняются в ходе сеанса.
• ⚡ Избегайте лишних преобразований типов данных внутри циклов обработки.

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

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

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

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

Почему запрос к регистру дополнительных реквизитов возвращает пустую таблицу?

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

Как получить список всех доступных дополнительных реквизитов для объекта?

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

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

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