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

Другое · 6 мин

Добавление реквизита справочника в расширение 1С

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

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

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

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

Когда расширение подходит, а когда прямая правка

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

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

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

Проверяйте, не блокирует ли конфигурация правку через расширение

Справочник в расширенииПолностью контролируется вами

Убедитесь, что объект не используется критическими подсистемами

Требуется отчётностьНовый реквизит может попадать в печатные формы

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

Подготовка и создание расширения

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

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

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

Добавление реквизита к справочнику

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

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

Справочник уже есть в расширении

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

Нужно добавить в существующий базовый справочник

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

Отображение реквизита в формах

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

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

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

Заполнение и использование в коде

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

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

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

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

Открытие карточки справочника
Норма

Новый реквизит отображается и сохраняется

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

Реквизит отсутствует или не сохраняется после закрытия

Форма списка
Норма

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

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

Колонка пуста или не добавляется

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

Завершается без ошибок блокировки

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

Появляются сообщения о несовместимости объектов

Проверка результата и ограничения

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

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

Итог

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

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

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

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

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

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

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

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

Безопасно ли вносить изменения прямо в рабочую базу?

Не рекомендуется; сначала проверьте изменения на копии или в тестовой среде и сделайте резервную копию рабочей базы.