К статье
Практический материал

Другое · 6 мин

Как сделать поле ввода в 1С и правильно привязать его к данным

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

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

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

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

Что такое поле ввода в конфигурации 1С

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

Различают обычные и управляемые формы. На управляемых формах поля настраиваются через форму и её атрибуты, а логика размещается в модуле формы. На обычных формах порядок аналогичен по сути, но отличается дизайнером и способами обращения к элементам из кода.

Значение нужно только пока форма открытаИспользуйте атрибут формы

Поле не требует записи в базу и подходит для промежуточного ввода.

Значение должно остаться после переоткрытияИспользуйте реквизит объекта

Нужно создать реквизит конфигурационного объекта и обеспечить запись документа или справочника.

Нужно выбрать значение из спискаНастройте список выбора или команду выбора

Проверьте, откуда берётся список и какие права есть у пользователя.

Поле на форме и реквизит объекта: в чем разница

Атрибут формы существует только в рамках открытой формы. Если пользователь ввёл значение и закрыл форму без записи, данные исчезнут. Такой подход удобен для фильтров, временных параметров и вспомогательных расчётов.

Реквизит объекта относится к конфигурационному объекту: справочнику, документу, плану видов характеристик и т. п. Значение записывается в базу вместе с объектом и доступно при повторном открытии. Создание реквизита требует изменения конфигурации и более внимательного тестирования.

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

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

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

Простое поле без сохранения в базе

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

Поле, сохраняемое в справочнике или документе

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

Настройка свойств и проверка ввода

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

Контрольные точки

Как проверить результат

Поле отображается на форме
Норма

Элемент виден и связан с атрибутом

Тревожный признак

Поле отсутствует или не связано с источником данных

Значение сохраняется
Норма

После переоткрытия формы значение осталось

Тревожный признак

Значение сбросилось после закрытия

Редактирование разрешено
Норма

Поле доступно для ввода

Тревожный признак

Поле только для просмотра или недоступно из-за прав

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

Ограничения, права и риски при доработке

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

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

Частые ошибки и как их избежать

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

Итог

Что важно запомнить

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

Почему введённое значение исчезает после переоткрытия формы?

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

Можно ли добавить поле без программирования?

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

Чем отличается реквизит объекта от атрибута формы?

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

Как проверить, что поле работает корректно?

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