Добавление реквизита на форму в расширении 1С Предприятие

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

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

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

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

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

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

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

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

Поиск целевой формы и добавление нового поля

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

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

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

• 📦 Тип данных: Выберите подходящий тип для нового поля, например, Строка, Число или Дата, в зависимости от того, какую информацию будет вводить пользователь.
• 🏷️ Имя и заголовок: Задайте уникальное имя реквизита (например, КомментарийМенеджера) и понятный заголовок, который будет виден в интерфейсе.
• 📍 Привязка к данным: Решите, будет ли реквизит храниться в базе данных или являться временным вычисляемым полем.

Настройка привязки к данным и источников значения

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

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

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

// Пример программного заполнения временного реквизита
&НаКлиенте
Процедура ПриОткрытии(Отказ)
Объект.КомментарийМенеджера = "Новый заказ от " + ТекущаяДата();
КонецПроцедуры

Что делать, если реквизит не сохраняется?

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

Размещение элементов на макете формы

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

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

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

Элемент управления	Назначение	Где использовать
Поле ввода	Ввод текста, чисел, дат	Основные данные документа
Флажок	Выбор состояния (Да/Нет)	Признаки, например "Новый клиент"
Список выбора	Выбор из предопределенных значений	Статусы, категории, типы
Декорация	Текст, картинка, разделитель	Пояснения и визуальное оформление

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

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

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

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

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

Тестирование и обновление расширенной конфигурации

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

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

Если вы планируете передавать расширение другим пользователям или на другие сервера, используйте механизм выгрузки. В конфигураторе выберите ваше расширение в дереве метаданных, нажмите правой кнопкой мыши и выберите Сохранить как... Будет создан файл с расширением .cfe. Этот файл можно загрузить в другую базу через меню Конфигурация -> Загрузить расширение конфигурации.

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

Можно ли добавить реквизит в расширение, если основная конфигурация закрыта от изменений?

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

Влияет ли большое количество расширений на скорость работы 1С?

Минимальное влияние есть, так как системе нужно загружать и компилировать дополнительный код. Однако при грамотной разработке и разумном количестве расширений (до 5-10 штук) падение производительности незаметно для пользователя. Критичным становится наличие десятков расширений с неоптимизированным кодом.

Что произойдет с данными в добавленных реквизитах при обновлении типовой конфигурации?

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

Как удалить реквизит, добавленный через расширение?

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

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

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