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

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

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

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

Подготовка конфигурации и открытие редактора форм

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

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

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

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

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

Создание нового поля на макете формы

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

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

• 📦 Поле ввода — универсальный элемент для ввода строк, чисел, дат и ссылок на объекты.
• ☑️ Флажок — используется для признаков, имеющих только два состояния (Да/Нет, Проведен/Не проведен).
• 📅 Поле даты — специализированный элемент с календарем для удобного выбора периода.

После размещения элемента на форме, он становится видимым пользователю. Однако, пока это просто "картинка", не связанная с данными. Следующим критически важным этапом является настройка свойств элемента через палитру свойств.

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

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

Самая важная часть настройки — это свойство Данные. Именно оно связывает визуальный элемент с переменной в модуле формы или реквизитом объекта. Если оставить это поле пустым, введенные пользователем данные исчезнут сразу после закрытия окна.

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

Свойство	Описание	Пример значения
Данные	Привязка к переменной или реквизиту	Объект.Комментарий
Заголовок	Текст, отображаемый рядом с полем	Комментарий менеджера
Ширина	Размер поля в символах или пикселях	50
Многострочность	Разрешение ввода нескольких строк текста	Истина

Для полей ввода часто требуется настройка свойства Многострочность. Если вы создаете поле для заметок или описания, установите это свойство в значение Истина, чтобы пользователь мог вводить текст с переносами строк. В противном случае текст будет обрезаться или вводиться в одну строку.

Также обратите внимание на свойство АвтоМаксимум для числовых полей. Оно позволяет системе автоматически определять максимальную длину числа, что упрощает верстку. Однако для финансовых реквизитов лучше задавать точную точность и длину вручную.

Что такое "Путь к данным"?

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

Группировка элементов и оформление интерфейса

Хаотичное расположение полей усложняет восприятие информации пользователем. Для структурирования данных используйте элементы группировки: Группа, Страница или Командная панель. Это позволяет разбить форму на логические блоки, например, "Основное", "Дополнительно", "Печать".

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

Используйте свойство Заголовок у групп, чтобы подписать разделы. Это повышает юзабилити интерфейса. Пользователь сразу понимает, где вводить цены, а где — адреса доставки. Хороший интерфейс снижает количество ошибок при вводе данных.

⚠️ Внимание: Избегайте создания слишком глубокой вложенности групп. Оптимальная глубина — не более 2-3 уровней. Чрезмерная вложенность усложняет поддержку кода и замедляет отрисовку формы.

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

Программная обработка и событие "ПриИзменении"

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

Откройте модуль формы через меню Конфигурация → Открыть модуль формы или комбинацию клавиш Ctrl+M. Найдите в списке процедур событие, связанное с вашим новым реквизитом. Оно будет называться примерно так: КомментарийМенеджераПриИзменении.

Процедура КомментарийМенеджераПриИзменении(Элемент)
// Здесь пишется код реакции на изменение
Если КомментарийМенеджера = "" Тогда
Сообщить("Поле не может быть пустым!");
КонецЕсли;
КонецПроцедуры

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

Если логика сложная, выносите её в отдельные процедуры или общие модули. Это делает код модуля формы чистым и понятным. Модуль формы должен содержать только код, непосредственно управляющий интерфейсом и реакцией на действия клиента.

Проверка работы и обновление базы данных

После внесения всех изменений необходимо обновить конфигурацию базы данных. Нажмите клавишу F7 или выберите в меню Конфигурация → Обновить конфигурацию базы данных. Система сравнит текущую конфигурацию с базой данных и предложит внести изменения.

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

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

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

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

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

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

Для этого создайте переменную в модуле формы через конструктор или вручную в секции Переменные. Затем в свойстве Данные элемента формы укажите имя этой переменной. Такие данные исчезнут после закрытия формы.

Почему новое поле не видно пользователю?

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

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

Да, алгоритм аналогичен. Нужно добавить реквизит в объект метаданных "Табличная часть", а затем добавить колонку в форму табличной части документа, связав её с новым реквизитом.

Как сделать поле обязательным для заполнения?

Используйте событие ПередЗаписью в модуле объекта или модуле формы. В коде проверьте заполненность поля и, если оно пустое, вызовите метод Отказ = Истина и выведите сообщение пользователю.