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