Другое · 9 мин
Как программно добавить поле ввода на форму 1С
Как программно добавить поле ввода на форму 1С: управляемые и обычные формы, привязка к данным, проверка результата, частые ошибки и безопасные правки.
Добавление поля ввода на форму в 1С часто требуется, когда стандартный состав реквизитов не покрывает задачу, но создавать отдельный справочник или документ нецелесообразно. Поле может быть привязано к существующему реквизиту объекта или быть независимым, например для ввода промежуточного значения при обработке.
Порядок действий зависит от типа формы. В обычных формах коллекция элементов доступна для изменения в модуле формы, а в управляемых формах состав элементов в основном определяется на этапе настройки конфигурации, и программное добавление произвольного поля во время выполнения ограничено возможностями платформы.
Перед правкой нужно уточнить, где будет использоваться поле: только на клиенте, в списке или документе, нужно ли сохранять значение в базе. От этого зависит выбор между привязкой к реквизиту и unbound-полем, а также необходимость обновления конфигурации.
Не каждый запрос на «дополнительное поле» требует программирования. Если нужно просто учесть новый реквизит документа или справочника, проще добавить его в конфигурацию и разместить на форме в конструкторе. Программное добавление оправдано для временных условий, динамических интерфейсов обработок или случаев, когда состав полей должен зависеть от прав пользователя или состояния данных.
Важно различать поле формы и реквизит объекта. Поле ввода может отображать значение реквизита, быть привязано к временной переменной формы или вообще не сохраняться нигде. Без привязки введённое пользователем значение обычно теряется при закрытии формы или перезапуске сеанса.
Когда программное поле оправдано, а когда лучше использовать конструктор
Программное добавление удобно, когда интерфейс должен формироваться условиями: например, показать дополнительное поле только для определённой категории контрагентов или при выборе конкретного вида операции. В таких случаях логика видимости и доступности поля пишется в модуле формы, а сам элемент создаётся один раз при открытии.
Если же поле нужно постоянно для всех пользователей и всех записей, конструктор конфигурации надёжнее. Поле, описанное в метаданных, легче поддерживать, переносить между базами и обновлять без риска нарушить работу типовой конфигурации. Программирование оправдано там, где статический состав элементов не решает задачу.
Сценарий: временный ввод в обработке
В внешней обработке или отчёте часто нужно получить от пользователя параметр, который не должен попадать в базу. Тогда достаточно unbound-поля ввода, не привязанного к реквизиту. Значение считывается в коде обработки и используется только в рамках текущего запуска.
Такой подход безопасен, потому что не изменяет структуру объектов и не влияет на записи. Недостаток: значение недоступно после закрытия обработки, если не сохранить его отдельно в регистр, файл или временное хранилище.
Сценарий: постоянное поле в документе
Для документа лучше добавить реквизит в конфигурацию, а затем разместить поле ввода на форме. Программное создание такого поля в каждом сеансе усложняет поддержку и может привести к расхождению между интерфейсом и структурой данных. Если реквизит уже есть, достаточно убедиться, что элемент формы имеет правильный ПутьКДанным.
При работе с типовыми конфигурациями изменения в метаданных могут блокироваться режимом поддержки. В этом случае используйте расширение конфигурации или обратитесь к администратору, а не правьте типовой модуль напрямую.
Обычные формы: добавление через модуль формы
На обычной форме элемент создаётся в модуле формы, обычно в обработчике ПриОткрытии или в специальной процедуре инициализации. Нужно указать имя элемента, тип ПолеВвода и родительский элемент, например группу или команду. После создания задаются заголовок, ширина, доступность и привязка к данным.
- 1Откройте модуль формы в режиме настройки конфигурации
- 2В обработчике открытия формы вызовите Элементы.Добавить с типом ПолеВвода
- 3Укажите ПутьКДанным, если поле должно быть привязано к реквизиту
- 4Настройте видимость, редактируемость и размеры
- 5Сохраните конфигурацию и проверьте форму на тестовой базе
Пример кода иллюстрирует общую логику, а не готовую копипаду для любой конфигурации. Имена элементов, групп и реквизитов нужно подставить под свою задачу. Если родительский элемент отсутствует, поле может не отобразиться или отобразиться в неожиданном месте.
Проверка результата включает открытие формы, ввод значения и попытку сохранить документ. Если привязка настроена верно, значение должно записываться в объект и оставаться после переоткрытия. Если поле не привязано, введённое значение не дойдёт до базы без дополнительного кода записи.
Управляемые формы: ограничения и альтернативы
В управляемых формах состав элементов в основном фиксируется в конфигураторе, и прямой аналог Элементы.Добавить для произвольных полей во время выполнения ограничен. Платформа может поддерживать динамические элементы только в определённых ситуациях, поэтому перед программным добавлением стоит уточнить возможности используемого релиза.
Если нужно изменить интерфейс управляемой формы, чаще всего правильный путь — добавить элемент в конструкторе формы и управлять его видимостью или редактируемостью программно. Это надёжнее, чем попытка создать элемент «с нуля» в процедуре открытия формы.
Альтернативой может быть использование команд интерфейса, отдельных форм параметров или табличных частей, где структура уже предусмотрена. Выбор зависит от того, нужно ли пользователю вводить одно значение или целый набор связанных данных.
Как проверить результат
Элемент виден и не перекрывает другие элементы
Элемент отсутствует или выходит за границы группы
После сохранения и переоткрытия данные остаются
Значение сбрасывается или не сохраняется
Пользователи с нужными правами видят и редактируют поле
Поле недоступно из-за прав или ролей
Свойства, привязка и проверка результата
После добавления поля важно проверить несколько свойств: имя элемента уникально на форме, ПутьКДанным указывает на существующий реквизит, а флаги доступности и редактируемости соответствуют задаче. Если поле должно быть только для просмотра, запретите редактирование, иначе пользователи могут ожидать записи значения, которой не произойдёт.
Признак корректной работы — сохранение значения между сеансами для привязанных полей и отсутствие ошибок при записи. Если поле отображается, но не пишет данные, проверьте не только привязку, но и режим проведения документа, права доступа и возможные блокировки объекта.
Не полагайтесь только на визуальное отображение. Поле может быть нарисовано на форме, но не иметь связи с данными из-за опечатки в пути или отсутствия реквизита в объекте. Логирование или отладка модуля формы поможет выявить, на каком этапе значение теряется.
Риски, права и обновление конфигурации
Изменение модулей форм и метаданных в рабочей базе без резервной копии может привести к потере данных или нарушению обмена. Всегда тестируйте правки на копии базы, а затем переносите в основную через обновление конфигурации. Типовые решения требуют осторожности: прямое изменение типовой формы может быть перезаписано при обновлении.
Права доступа тоже влияют на результат. Даже правильно созданное поле может быть недоступно для пользователя из-за ролей или прав на объект. Проверяйте доступ не только у администратора, но и у обычных пользователей, для которых предназначена форма.
Если после добавления поля форма открывается медленно или выдаёт ошибку при компиляции, откажите изменение и сравните с рабочей версией. Не оставляйте неоткомпилированный код в рабочей среде, так как это может заблокировать открытие формы для всех пользователей.
Типичные ошибки
Ещё одна частая ошибка — создание поля с именем, которое уже используется на форме или в модуле. Это вызывает конфликт имён и ошибку компиляции. Перед добавлением проверьте уникальность имени элемента и отсутствие одноимённых реквизитов в области видимости.
Не пренебрегайте документацией пользователей. Если поле появилось программно, но не описано в инструкции, сотрудники могут не понять его назначение или вводить некорректные данные. Краткое описание рядом с полем или в справочной системе снижает количество ошибок ввода.
Что важно запомнить
Выбирайте способ в зависимости от типа формы и цели: конструктор для постоянных полей, программирование для временных и условных интерфейсов, проверяйте привязку и права.
Можно ли добавить поле без программирования?
Да, если достаточно постоянного реквизита. Добавьте его в конфигурацию объекта и разместите на форме через конструктор, а затем настройте видимость и доступность в свойствах элемента. Программирование нужно главным образом для динамического или условного состава полей.
Будет ли значение поля сохраняться в базе?
Только если поле привязано к реквизиту объекта, а форма поддерживает запись этого объекта. Unbound-поле существует только в рамках текущей формы и сеанса; после закрытия его значение обычно не сохраняется без дополнительного кода.
Почему поле может не отображаться на управляемой форме?
Состав элементов управляемой формы в основном задаётся в конфигураторе, а прямое добавление произвольных элементов во время выполнения ограничено. Попробуйте описать поле в конструкторе и управлять его видимостью программно, уточнив возможности используемого релиза платформы.
Что делать, если поле не записывает значение?
Проверьте ПутьКДанным, существование привязанного реквизита, флаги редактируемости и права пользователя. Также убедитесь, что объект не находится в режиме, блокирующем запись, и что изменения сохраняются после проведения или сохранения документа.
Нужно ли перезапускать 1С после изменений?
После изменения конфигурации обычно требуется обновить конфигурацию и переоткрыть форму, а в некоторых случаях перезапустить клиентское приложение. Точная необходимость зависит от вида изменения и используемого клиента: тонкий, толстый или веб.