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

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

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

Важно понимать разницу между реквизитом формы и элементом формы. Реквизит — это данные, которые хранятся в форме. Элемент — это визуальное отображение: поле ввода, флажок, кнопка, надпись. Элемент без привязки к реквизиту не сможет хранить и показывать данные, поэтому обычно сначала создают реквизит, а затем связывают с ним элемент.

Подготовка: где редактируется форма

Работа ведётся в конфигураторе 1С. Откройте нужный объект конфигурации — например, документ или справочник — и перейдите на закладку «Формы». Если основная форма объекта ещё не создана, платформа предложит сгенерировать её автоматически конструктором. Если форма уже существует, откройте её двойным щелчком.

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

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

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

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

Для строковых реквизитов укажите длину строки: неограниченная строка (длина 0) неудобна для полей ввода и может ограничивать возможности сортировки и поиска. Для ссылочных типов выберите конкретный тип — например, СправочникСсылка.Контрагенты. Составной тип допустим, но усложняет отображение и обработку.

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

Добавление элемента на форму визуально

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

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

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

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

Настройка свойств элемента

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

Для полей ввода полезны свойства КнопкаВыбора, КнопкаОчистки, Маска и ПодсказкаВвода. Для надписей и декораций настраиваются шрифт, цвет текста и фона. Для кнопок обязательно укажите имя команды — либо существующей команды формы, либо новой, которую нужно создать на закладке «Команды» и наполнить обработчиком в модуле формы.

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

Программное добавление элемента

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

Типовой фрагмент кода выглядит так. Сначала формируется массив добавляемых реквизитов с объектами Новый РеквизитФормы, затем вызывается ИзменитьРеквизиты. После этого создаётся элемент: НовыйЭлемент = Элементы.Добавить("КомментарийМенеджера", Тип("ПолеФормы"), Родитель), задаётся ПутьКДанным и вид поля.

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

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

Добавление элемента через расширение конфигурации

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

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

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

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

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

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

Ответы на частые вопросы