Программная работа с дополнительными реквизитами в 1С

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

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

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

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

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

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

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

Синтаксис чтения значения реквизита

Для получения значения дополнительного реквизита используется свойство ДополнительныеРеквизиты, к которому применяется индексация по имени реквизита. Имя реквизита передается как строка в квадратных скобках. Это аналог работы с ассоциативными массивами в других языках программирования. Синтаксис выглядит следующим образом: Значение = Объект.ДополнительныеРеквизиты["ИмяРеквизита"].

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

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

• 🔍 Всегда проверяйте существование реквизита перед использованием, если его наличие не гарантировано логикой программы.
• 📝 Учитывайте регистр символов в имени реквизита, хотя платформа 1С обычно нечувствительна к регистру в именах метаданных, в строковых константах лучше соблюдать точность.
• ⚡ Для частого обращения к одному и тому же реквизиту в цикле лучше сохранить ссылку на коллекцию в переменную, чтобы избежать лишнего вызова свойства.

Запись данных и установка значений

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

Для записи используется тот же синтаксис индексации, но в режиме присваивания. Например: Объект.ДополнительныеРеквизиты["ИмяРеквизита"] = НовоеЗначение. Платформа автоматически выполнит проверку типа записываемого значения на соответствие типу, определенному в свойствах дополнительного реквизита. Если типы несовместимы и автоматическое приведение невозможно, возникнет ошибка.

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

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

Обработка ошибок и проверка существования

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

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

Попытка
ЗначениеРеквизита = Документ.ДополнительныеРеквизиты["СерийныйНомерПоставщика"];
Исключение
ЗначениеРеквизита = Неопределено;
КонецПопытки;

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

Почему возникает ошибка "Индекс за пределами диапазона"?

Эта ошибка появляется, если вы пытаетесь обратиться к реквизиту по числовому индексу (например, [0]), а в коллекции меньше элементов, чем указанный индекс. Всегда используйте строковые имена для надежности.

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

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

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

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

Метод доступа	Производительность	Сложность реализации	Рекомендуемое использование
Свойство объекта	Низкая (по одному)	Низкая	Редактирование карточки, единичные операции
Язык запросов	Высокая (пакетно)	Средняя	Отчеты, массовая обработка, выборки
Консоль запросов	Высокая	Высокая	Администрирование, отладка, разовые выгрузки
СКД (Система Компоновки)	Высокая	Средняя	Пользовательские отчеты, печатные формы

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

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

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

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

⚠️ Внимание: Не пытайтесь напрямую изменять структуру дополнительных реквизитов (добавлять новые) из клиентского кода. Эти операции требуют прав администратора и выполняются только на сервере или в конфигураторе.

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

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

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

Можно ли использовать дополнительные реквизиты в условиях отбора СКД?

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

Что делать, если при записи возникает ошибка "Значение не является значением объектного типа"?

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

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

Для очистки значения достаточно записать в него значение Неопределено или пустую строку (в зависимости от типа реквизита). Например: Объект.ДополнительныеРеквизиты["Комментарий"] = Неопределено. Это вернет поле в состояние "не заполнено".