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

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

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

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

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

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

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

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

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

Получение реквизитов через объект метаданных

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

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

Рассмотрим пример получения значения конкретного реквизита по его имени. Предположим, у нас есть элемент справочника Номенклатура, и нам нужно узнать значение реквизита "Цвет". Код будет выглядеть следующим образом:

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

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

• 🔹 Использование свойства ДополнительныеРеквизиты автоматически подгружает данные из базы.
• 🔹 Динамическое обращение через метод Получить() требует передачи имени строкой.
• 🔹 Тип возвращаемого значения соответствует типу, заданному в плане видов характеристик.

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

Использование запросов для выборки данных

Когда требуется получить значения дополнительных реквизитов для большого списка объектов, обращение через объект в цикле становится неэффективным. Оптимальным решением является использование языка запросов 1С. Платформа предоставляет специальные псевдо-таблицы для работы с ДР и ДС.

В тексте запроса дополнительные реквизиты доступны через виртуальную таблицу ДополнительныеРеквизиты. Она позволяет получить сразу все значения для выбранных объектов. Синтаксис требует указания плана видов характеристик в качестве параметра.

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

Обратите внимание на использование параметра &СвойствоЦвет. В запросы нельзя подставлять объекты метаданных напрямую в текст, их необходимо передавать через параметры. Значением параметра должна быть ссылка на элемент плана видов характеристик.

Если реквизитов много и их набор динамичен, использование оператора ВЫБРАТЬ ИЗ ДополнительныеРеквизиты с группировкой или последующей обработкой в коде часто является единственным верным решением. Это позволяет избежать жесткой привязки к именам полей.

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

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

Работа с планом видов характеристик

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

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

Свойство элемента	Описание	Тип данных
Имя	Системное имя реквизита в коде	Строка
Представление	Наименование для пользователя	Строка
Порядок	Порядок отображения в форме	Число
Владелец	План, которому принадлежит характеристика	Ссылка

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

ПВХ = ПланыВидовХарактеристик.ДополнительныеРеквизитыНоменклатуры;
Выборка = ПВХ.Выбрать();
Пока Выборка.Следующий() Цикл
Сообщить(Выборка.Представление + " (" + Выборка.Имя + ")");
КонецЦикла;

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

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

Особенности иерархии планов

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

Обработка типовых значений и приведение типов

Одной из главных сложностей при работе с ДР является неопределенность типа данных. В одном и том же реквизите "Комментарий" может храниться строка, а в реквизите "Дата выпуска" — дата. Программный код должен быть готов к любому варианту.

При получении значения через объект или запрос, 1С возвращает значение типа ЗначениеДополнительногоРеквизита или универсальное значение. Для работы с ним часто требуется явное приведение типа. Используйте функцию ТипЗнч() для анализа.

Рассмотрим ситуацию, когда нужно вывести значение, независимо от его типа. Безопасный подход включает проверку типа перед выполнением специфических операций:

ЗначениеДР = Элемент.ДополнительныеРеквизиты.Получить("МойРеквизит");
Если ТипЗнч(ЗначениеДР) = Тип("Строка") Тогда
ОбработанныйТекст = СтрЗаменить(ЗначениеДР, " ", "_");
ИначеЕсли ТипЗнч(ЗначениеДР) = Тип("Число") Тогда
ОбработанныйТекст = Формат(ЗначениеДР, "ЧГ=0");
КонецЕсли;

Частой ошибкой является попытка вызвать строковые методы у числа или даты без предварительной проверки. Это приводит к остановке выполнения скрипта. Всегда используйте конструкцию Попытка..Исключение или строгую типизацию.

• 🔹 Используйте ТипЗнч() для определения фактического типа значения.
• 🔹 Применяйте Формат() для унифицированного вывода разных типов в строку.
• 🔹 Проверяйте значение на Неопределено перед обращением к свойствам.

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

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

Оптимизация производительности при массовом чтении

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

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

Алгоритм оптимизации выглядит так: сначала формируется список ссылок на объекты. Затем одним запросом выбираются все дополнительные реквизиты для этого списка. Результат сохраняется в локальную структуру данных. Далее работа ведется только с оперативной памятью.

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

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

Кэширование на клиенте

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

Частые ошибки и способы их устранения

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

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

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

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

• 🔹 Ошибка "Объект не найден" при динамическом обращении к свойству.
• 🔹 Получение пустых значений из-за отсутствия прав доступа (RLS).
• 🔹 Медленная работа из-за отсутствия индексов в регистре сведений.

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

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

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

Можно ли использовать ДР в условиях отбора запроса?

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

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

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

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

Для удаления значения присвойте реквизиту значение Неопределено. Например: Элемент.ДополнительныеРеквизиты.МойРеквизит = Неопределено. Это очистит запись в регистре сведений.

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

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