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

Другое · 6 мин

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

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

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

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

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

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

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

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

Как добавить реквизит в конфигурацию

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

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

Права на конфигурациюМожно ли править

Проверьте, открыта ли конфигурация и есть ли права администратора

Тип объектаГде добавлять

Уточните, поддерживает ли справочник или документ дополнительные реквизиты

Имя реквизитаКак читать

Скопируйте имя точно, включая регистр, из свойств конфигурации

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

Как заполнить и получить значение

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

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

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

Отличие от свойств, характеристик и регистров

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

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

Права, обновления и безопасные изменения

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

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

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

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

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

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

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

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

Отображается и принимает значение

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

Отсутствует или не сохраняется

Программное чтение
Норма

Возвращает введённое значение

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

Возвращает пустое значение без ошибки

После обновления конфигурации
Норма

Поле остается на месте

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

Поле исчезает или форма выдает ошибку

Когда не стоит добавлять реквизит

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

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

Итог

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

Добавляйте реквизит в свойствах объекта, читайте по точному имени, тестируйте на копии и избегайте прямой правки защищенной конфигурации.

Нужно ли программирование, чтобы получить значение?

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

Что делать, если значение не отображается?

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

Можно ли редактировать реквизит в типовой конфигурации?

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

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

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