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

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

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

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

Понятие дополнительных реквизитов и сведений

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

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

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

📌 Реквизиты — хранятся в основном объекте, доступны сразу, не имеют периодичности.
📅 Сведения — хранятся в отдельном регистре, могут быть периодическими, удобны для истории.
⚙️ Настройка — оба типа настраиваются через форму "Дополнительные реквизиты и сведения".

⚠️ Внимание! При большом количестве дополнительных реквизитов (более 20-30) таблица объекта может значительно разрастись, что повлияет на производительность выборки данных. В таких случаях целесообразнее использовать дополнительные сведения.

Настройка через интерфейс пользователя

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

Для начала работы откройте список интересующего вас справочника. В верхней панели команд найдите кнопку "Еще" и выберите пункт Изменить форму или сразу перейдите к настройке состава данных. В современных версиях платформы путь часто выглядит как Сервис → Дополнительные реквизиты и сведения.

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

💡

Используйте префиксы в наименовании реквизитов (например, "Доп_Цвет"), чтобы визуально отделять их от основных полей конфигурации при анализе структуры базы.

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

Получение реквизитов в режиме Предприятия

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

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

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

Действие	Меню / Кнопка	Результат
Открытие настроек	`Еще → Изменить форму`	Конструктор формы
Поиск полей	Группа "Доп. реквизиты"	Список всех полей
Сохранение	Кнопка "ОК"	Обновление интерфейса

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

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

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


// Пример получения значения дополнительного реквизита
ЭлементСправочника = Справочники.Номенклатура.НайтиПоНаименованию("Товар А");
ЗначениеРеквизита = ЭлементСправочника.ДополнительныеРеквизиты["Доп_Цвет"].Значение;
Сообщить("Цвет товара: " + ЗначениеРеквизита);

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

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

Если вы попытаетесь обратиться к удаленному пользователем реквизиту по имени, система выдаст ошибку "Реквизит не найден". Всегда используйте конструкцию "Попытка..Исключение" или проверку "Если ДополнительныеРеквизиты.Свойство(..)".

Использование в запросах и отчетах

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

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

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

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

🔍 Используйте псевдонимы для таблиц с доп. реквизитами в запросах.
📊 В СКД добавляйте поля через настройку "Доступные поля" источника данных.
🚀 Кэшируйте метаданные при частом обращении к доп. реквизитам в циклах.

💡

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

Обработка ошибок и ограничения

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

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

Также существует ограничение на длину строковых значений. Стандартная длина часто ограничена 150 или 250 символами. Если бизнес-процесс требует хранения длинных текстов (комментарии, описания), стандартного строкового реквизита может не хватить.

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

Уточнить тип данныхПроверить длину строкиОценить влияние на производительностьПротестировать в отчетах

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

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

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

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

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

Как удалить лишний дополнительный реквизит?

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

Видны ли дополнительные реквизиты в выгрузке XML/JSON?

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

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

Незначительно. Если реквизитов мало (до 10-15), влияние незаметно. При большом количестве полей или записей (миллионы строк) рекомендуется использовать индексирование или перенос данных в дополнительные сведения.

Как получить дополнительные реквизиты справочника в 1С