Как добавить поле ввода на форму в 1С

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

Ключевой момент, который часто упускают новички: поле ввода на форме — это только элемент отображения. Чтобы введённое значение куда-то сохранялось, поле должно быть связано с реквизитом объекта (справочника, документа) или с реквизитом формы. Поле без связи с данными будет просто очищаться при закрытии формы.

Ниже разобраны все три способа с конкретными шагами, типовыми ошибками и способами проверки результата. Инструкции применимы к управляемым формам на платформе 1С:Предприятие 8.3 — именно они используются в типовых конфигурациях.

Что нужно подготовить перед добавлением поля

Прежде чем добавлять поле, определите, где будут храниться вводимые данные. Если значение должно сохраняться в базе (например, новый реквизит справочника «Номенклатура»), сначала добавьте реквизит в объект конфигурации. Если значение нужно только временно — например, параметр для отбора или расчёта — достаточно реквизита формы, который существует только пока форма открыта.

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

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

Добавление поля ввода через конфигуратор

Это базовый способ, который подходит для собственных конфигураций и для случаев, когда изменения в типовой конфигурации осознанно приняты. Откройте конфигуратор, найдите нужный объект (справочник, документ, обработка) в дереве конфигурации, раскройте ветку «Формы» и откройте нужную форму двойным щелчком.

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

1. 1
   Откройте конфигуратор и найдите объект в дереве конфигурации
2. 2
   При необходимости добавьте реквизит объекту на вкладке «Данные»
3. 3
   Откройте форму объекта двойным щелчком
4. 4
   В правой панели найдите нужный реквизит в списке реквизитов формы
5. 5
   Перетащите реквизит мышью в дерево элементов формы в нужное место (группу)
6. 6
   Проверьте свойства элемента: вид поля, заголовок, доступность
7. 7
   Обновите конфигурацию базы данных (F7) и проверьте результат в режиме 1С:Предприятие

Платформа автоматически создаёт элемент «Поле ввода» и подбирает его вид по типу данных: для строки — текстовое поле, для даты — поле с календарём, для ссылки — поле с кнопкой выбора. Вид можно изменить в палитре свойств элемента (правый клик → «Свойства»), например переключить на «Поле переключателя» или «Поле флажка» для булева типа.

Добавление реквизита формы без сохранения в базе

Если значение нужно только для работы на форме, в редакторе формы нажмите кнопку «Добавить реквизит» в панели реквизитов (иконка с зелёным плюсом), задайте имя и тип, затем перетащите созданный реквизит в дерево элементов. Такой реквизит живёт только в памяти: после закрытия формы значение теряется, зато не требуется изменение структуры базы данных и реструктуризация.

Программное добавление поля ввода

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

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

&НаСервере
Процедура ПриСозданииНаСервере(Отказ, СтандартнаяОбработка)
    ДобавляемыеРеквизиты = Новый Массив;
    НовыйРеквизит = Новый РеквизитФормы("КомментарийДоп", Новый ОписаниеТипов("Строка", , Новый КвалификаторыСтроки(200)));
    ДобавляемыеРеквизиты.Добавить(НовыйРеквизит);
    ИзменитьРеквизиты(ДобавляемыеРеквизиты);

    НовоеПоле = Элементы.Добавить("ПолеКомментарийДоп", Тип("ПолеФормы"), Элементы.ГруппаДополнительно);
    НовоеПоле.Вид = ВидПоляФормы.ПолеВвода;
    НовоеПоле.ПутьКДанным = "КомментарийДоп";
    НовоеПоле.Заголовок = "Комментарий";
КонецПроцедуры

Обратите внимание: третий параметр метода «Добавить» — родительский элемент (группа формы). Если его не указать, поле попадёт в корень формы и может оказаться в непредсказуемом месте интерфейса. Указывайте конкретную группу, в которой поле должно отображаться.

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

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

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

Если данные всё-таки нужно хранить в базе, в типовых конфигурациях часто есть механизм дополнительных реквизитов и сведений (в режиме 1С:Предприятие: «Администрирование» → «Общие настройки» → «Дополнительные реквизиты и сведения»). Добавленный там реквизит автоматически появляется на форме объекта в группе «Дополнительные реквизиты» — безо всякого конфигурирования.

Проверка результата и типовые ошибки

После добавления поля обновите конфигурацию базы данных (клавиша F7 в конфигураторе) — без этого изменения реквизитов объекта не применятся, и 1С выдаст ошибку при открытии формы. Если добавляли только элементы формы или реквизиты формы, достаточно перезапустить сеанс или переоткрыть форму.

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

Ограничения и когда нужен разработчик

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

К разработчику стоит обратиться, если поле должно участвовать в обменах данными, печатных формах, отчётах или синхронизации с другими системами — здесь недостаточно просто вывести элемент на форму, нужно учесть всю цепочку использования данных. Также помощь нужна при работе с обычными формами старых конфигураций (там механизм другой) и при доработке форм с жёсткой программной логикой расположения элементов.

Частые вопросы