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

Другое · 7 мин

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

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

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

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

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

Чем отличается метаданное поле от значения реквизита

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

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

Нужно добавить поле в объектЭто работа с метаданными

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

Нужно заполнить поле у объектаЭто работа с данными

Достаточно обычного кода встроенного языка в режиме работы приложения.

Когда реквизит можно создать только в Конфигураторе

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

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

Создание реквизита через расширение конфигурации

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

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

1c
Объект = Справочники.Номенклатура.НайтиПоНаименованию("Товар");
Если Не Объект.Пустая() Тогда
    Объект.ЕдиницаИзмерения = Справочники.ЕдиницыИзмерения.НайтиПоНаименованию("Штука");
    Объект.Записать();
КонецЕсли;

Программное заполнение существующего реквизита в режиме работы

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

Важно проверять результат записи: если метод Записать() вернул ложь или возникло исключение, объект не сохранён. В managed-приложении также нужно учитывать права доступа, блокировки и обязательные реквизиты, без которых запись будет отвергнута.

Контрольные точки

Как проверить результат

Новое поле в редакторе объекта конфигурации
Норма

Реквизит отображается в списке свойств с нужным типом

Тревожный признак

Поле отсутствует или тип не соответствует задаче

Поле на форме объекта
Норма

Реквизит доступен для ввода и отображает значение

Тревожный признак

Поле не добавлено на форму или доступ только для чтения

Программная запись объекта
Норма

Метод Записать() завершается без исключений

Тревожный признак

Ошибка записи, отказ прав или нарушение обязательных реквизитов

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

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

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

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

Ограничения, риски и альтернативы

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

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

Итог

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

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

Можно ли создать реквизит прямо в рабочей базе без Конфигуратора?

В обычном режиме работы 1С нет безопасного встроенного способа добавить новое метаданное поле к объекту. Это требует Конфигуратора или расширения конфигурации с соответствующими правами и обновлением базы.

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

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

Отличается ли порядок для управляемого и обычного приложения?

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

Нужно ли делать резервную копию перед изменением реквизитов?

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