К статье
Практический материал

Другое · 6 мин

Как программно добавить реквизит в 1С

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

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

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

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

Что понимать под реквизитом в 1С

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

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

Реквизит уже есть в объектеМожно заполнять скриптом

Проверьте имя свойства в модуле объекта и доступ на запись

Нужно новое поле в базеТребуется изменение конфигурации

Вносите правку в Конфигураторе и обновляйте базу

Нужно дополнительное поле без программированияИспользуйте дополнительные реквизиты

Убедитесь, что механизм поддерживается конфигурацией

Когда реквизит можно добавить программно, а когда нет

В обычном приложении 1С:Предприятия скрипт не создаёт новые колонки таблиц и не пересоздаёт структуру объектов. Попытка обратиться к несуществующему реквизиту приведёт к ошибке компиляции или выполнения. Поэтому «программно добавить» обычно означает присвоить значение уже существующему свойству.

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

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

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

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

Порядок действий
  1. 1
    Убедитесь, что реквизит существует в конфигурации или подключён как дополнительный
  2. 2
    Откройте объект для записи в модуле кода
  3. 3
    Присвойте значение свойству объекта
  4. 4
    Запишите объект и проверьте результат в интерфейсе

Заполнение реквизита объектом в коде

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

Объект.МойРеквизит = Значение;
Объект.Записать();

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

1c
&НаСервере
Процедура ЗаписатьРеквизит(Объект, Значение)
    Объект.МойРеквизит = Значение;
    Объект.Записать();
КонецПроцедуры

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

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

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

Типичные ошибки
01
Обращение к несуществующему реквизиту вызывает ошибку выполнения
02
Изменение конфигурации в рабочей базе без резервной копии и тестирования
03
Забывчивость обновить базу после добавления реквизита в Конфигураторе

Частые ошибки и альтернативы

Частая ошибка — попытка присвоить значение несуществующему реквизиту или обратиться к свойству по опечатке в имени. Другая ошибка — попытка изменить конфигурацию из пользовательского кода без прав разработчика. Также часто забывают обновить базу конфигурации после добавления поля в Конфигураторе.

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

Итог

Что важно запомнить

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

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

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

Чем отличается конфигурационный реквизит от дополнительного?

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

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

Откройте объект в интерфейсе после записи, переоткройте его и убедитесь, что значение на месте. Можно также выполнить запрос к данным объекта или соответствующему регистру и сравнить результат с введённым значением.

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

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