Добавление реквизита на форму в 1С с помощью расширений

Разработка в системе 1С:Предприятие часто требует внесения изменений в стандартный функционал без права модификации конфигурации. Механизм расширений (Extensions) стал стандартом де-факто для таких задач, позволяя безопасно дорабатывать поведение объектов. Одной из самых частых задач является необходимость вывести на экран пользователя новую информацию, которой нет в базовом решении.

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

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

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

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

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

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

• 🔍 Проверьте, включен ли режим расширений в свойствах базы данных.
• 📂 Убедитесь, что у вас есть права на изменение конфигурации в режиме конфигуратора.
• 💾 Сохраните конфигурацию перед началом внесения изменений, чтобы иметь точку отката.
• ⚙️ Выберите правильную версию платформы в свойствах расширения для совместимости.

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

Создание нового реквизита в структуре данных

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

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

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

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

Размещение элемента управления на форме

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

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

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

Свойство элемента	Описание назначения	Типичное значение
Данные	Связь с реквизитом формы или объекта	ДополнительнаяИнформация
Заголовок	Текст подписи, видимый пользователю	Комментарий менеджера
ТолькоПросмотр	Запрет на редактирование поля	Ложь (для ввода)
Многострочный	Разрешение ввода текста в несколько строк	Истина (для комментариев)

Настройка свойств и условного оформления

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

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

Для более сложной логики, которую нельзя выразить средствами конструктора, используется код модуля формы. В событии ПриСозданииНаСервере или ОбработкаОповещения можно программно менять свойства элементов. Используйте конструкцию Элементы.ИмяЭлемента.Видимость = Ложь для скрытия поля или Элементы.ИмяЭлемента.ТолькоПросмотр = Истина для блокировки ввода.

• 🎨 Используйте разные цвета фона для выделения обязательных полей расширений.
• 👁️ Скрывайте технические поля от обычных пользователей, оставляя их доступными для администраторов.
• 🔒 Блокируйте редактирование полей, если документ уже проведен или помечен на удаление.
• 📝 Добавляйте подсказки к полям через свойство "Подсказка при вводе" для улучшения UX.

⚠️ Внимание: Изменение свойств элементов на клиенте (в событиях формы) происходит мгновенно, но не сохраняется в базе данных. Если вы измените видимость поля, это повлияет только на текущую сессию пользователя. Для сохранения состояния логики используйте реквизиты формы.

Программная обработка событий ввода

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

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

&НаКлиенте
Процедура ДополнительнаяИнформацияПриИзменении(Элемент)
Если ЗначениеЗаполнено(Объект.ДополнительнаяИнформация) Тогда
Сообщить("Поле заполнено, проверяем условия..");
// Здесь может быть вызов общей команды или проверка логики
КонецЕсли;
КонецПроцедуры

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

Особенности контекста выполнения

Код в модуле формы расширения выполняется в том же контексте, что и код основной формы. Однако, вы не можете напрямую изменять код модуля объекта (документа или справочника) из расширения. Все изменения поведения должны реализовываться через события формы или подписки на события объекта.

Проверка работы и публикация расширения

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

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

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

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

Часто задаваемые вопросы (FAQ)

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

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

Что делать, если после обновления конфигурации расширение перестало работать?

Скорее всего, изменилась внутренняя структура объекта или имена элементов формы. Зайдите в конфигуратор, обновите расширение (правая кнопка на расширении -> Обновить) и проверьте, не сбросились ли связи элементов формы с реквизитами. Возможно, потребуется вручную перенастроить свойства элементов.

Как скрыть добавленный реквизит от определенных пользователей?

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

Сохраняются ли данные в реквизитах формы, если они не добавлены в объект?

Нет, реквизиты, созданные непосредственно в форме (а не в объекте), существуют только в оперативной памяти во время работы с формой. После закрытия окна или записи объекта эти данные будут утеряны, если их не передать в реквизиты самого объекта программно.

Можно ли использовать расширение для изменения типа существующего реквизита?

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