Другое · 6 мин
Как программно добавить реквизит в 1С
Программное добавление реквизита в 1С: конфигурационное и дополнительное, порядок действий, проверка результата, частые ошибки и ограничения справочников и документов.
Реквизит в 1С — это свойство объекта конфигурации, например справочника, документа или перечисления. Конфигурационные реквизиты описывают структуру данных и создаются в Конфигураторе, а не в обычном режиме работы пользователя. Поэтому фраза «добавить реквизит программно» часто скрывает две разные задачи: изменить метаданные или заполнить уже существующее свойство объекта.
В режиме предприятия метаданные в основном доступны только для чтения. Скрипт не может просто создать новое поле в таблице базы данных и сразу использовать его в форме. Нужно либо заранее добавить реквизит в конфигурации, либо использовать механизмы дополнительных реквизитов и сведений, если платформа и конфигурация это поддерживают.
Перед любыми изменениями нужно сделать резервную копию базы и проверить работу на копии, а не вживую. Неправильное изменение структуры может привести к ошибкам записи, некорректным отчетам и потере данных. Самостоятельно безопасно работать только с заполнением существующих реквизитов и стандартными дополнительными свойствами.
Что понимать под реквизитом в 1С
Конфигурационный реквизит задаёт тип данных, длину, обязательность и место хранения значения. Он появляется в объектах после обновления базы конфигурации и доступен в модулях объектов через имя свойства. Такой реквизит является частью структуры приложения и требует прав разработчика.
Дополнительные реквизиты и сведения позволяют расширять объекты без изменения конфигурации, если механизм включён. Они хранятся отдельно и привязываются к конкретным видам объектов. Это удобно для временных или индивидуальных полей, но работа с ними имеет свои правила отбора и записи.
Проверьте имя свойства в модуле объекта и доступ на запись
Вносите правку в Конфигураторе и обновляйте базу
Убедитесь, что механизм поддерживается конфигурацией
Когда реквизит можно добавить программно, а когда нет
В обычном приложении 1С:Предприятия скрипт не создаёт новые колонки таблиц и не пересоздаёт структуру объектов. Попытка обратиться к несуществующему реквизиту приведёт к ошибке компиляции или выполнения. Поэтому «программно добавить» обычно означает присвоить значение уже существующему свойству.
Если нужно действительно новое поле, изменения вносятся в Конфигураторе: открывается объект, создаётся реквизит, настраиваются тип и обязательность, конфигурация сохраняется и обновляется база. Только после этого код может работать с новым свойством. Это относится к справочникам, документам, перечислениям и другим метаобъектам.
Дополнительные реквизиты и сведения
Если конфигурация поддерживает дополнительные реквизиты, их можно подключить к объекту через соответствующий план видов характеристик. После этого значения хранятся в регистрах дополнительной информации и доступны через стандартные методы чтения и записи. Это не требует изменения таблиц основных объектов.
При программной работе с дополнительными реквизитами важно правильно указать вид объекта, имя реквизита и значение. Не все формы автоматически отображают дополнительные поля, поэтому может потребоваться настройка интерфейса отдельно от заполнения данных.
- 1Убедитесь, что реквизит существует в конфигурации или подключён как дополнительный
- 2Откройте объект для записи в модуле кода
- 3Присвойте значение свойству объекта
- 4Запишите объект и проверьте результат в интерфейсе
Заполнение реквизита объектом в коде
Типичная запись существующего реквизита выглядит как обращение к свойству объекта и вызов метода записи. Например, в модуле объекта или на сервере можно присвоить значение и сохранить документ. Точный синтаксис зависит от типа приложения: управляемое или обычное, клиент или сервер.
Объект.МойРеквизит = Значение;Объект.Записать();
После записи откройте карточку объекта в интерфейсе и убедитесь, что значение отображается и сохраняется после переоткрытия. Если поле не появляется, проверьте права доступа, видимость реквизита в форме и наличие обновления базы после изменения конфигурации.
&НаСервере
Процедура ЗаписатьРеквизит(Объект, Значение)
Объект.МойРеквизит = Значение;
Объект.Записать();
КонецПроцедурыПроверка результата и безопасность
Проверяйте не только отсутствие ошибок при записи, но и сохранность значения после перезапуска сеанса. Сравните данные в форме с данными в отчёте или запросе по соответствующему регистру или таблице объекта. Если значение пропадает, причина может быть в отмене транзакции, отсутствии прав или неверном объекте записи.
Не вносите изменения в конфигурацию в рабочей базе в рабочее время. Используйте изолированную среду, резервное копирование и согласование с администратором базы. Неправильно настроенное обязательное поле может заблокировать проведение документов и создание новых записей.
Частые ошибки и альтернативы
Частая ошибка — попытка присвоить значение несуществующему реквизиту или обратиться к свойству по опечатке в имени. Другая ошибка — попытка изменить конфигурацию из пользовательского кода без прав разработчика. Также часто забывают обновить базу конфигурации после добавления поля в Конфигураторе.
Альтернативой программному добавлению поля может быть использование регистра сведений, табличной части документа или дополнительного реквизита. Выбор зависит от того, нужно ли поле постоянно, сколько объектов его будут использовать и требуется ли отчётность по этому значению.
Что важно запомнить
Новый конфигурационный реквизит создаётся в Конфигураторе, а программно заполняются уже существующие свойства или дополнительные реквизиты при поддержке конфигурации.
Можно ли создать новый реквизит справочника скриптом в режиме предприятия?
Обычно нет. Метаданные справочника в режиме предприятия доступны для чтения, а создание нового поля требует изменения конфигурации в Конфигураторе и обновления базы. Скрипт может только заполнить уже существующий реквизит.
Чем отличается конфигурационный реквизит от дополнительного?
Конфигурационный реквизит является частью структуры объекта и настраивается разработчиком в Конфигураторе. Дополнительный реквизит подключается через механизм дополнительных реквизитов и сведений без изменения основной структуры объекта, если это предусмотрено конфигурацией.
Как проверить, что реквизит записался правильно?
Откройте объект в интерфейсе после записи, переоткройте его и убедитесь, что значение на месте. Можно также выполнить запрос к данным объекта или соответствующему регистру и сравнить результат с введённым значением.
Что делать, если после добавления реквизита в Конфигураторе поле не видно в форме?
Проверьте, обновлена ли база конфигурации, добавлено ли поле на форму и есть ли у пользователя права на его просмотр и редактирование. Возможно, потребуется обновить конфигурацию и переоткрыть сеанс.