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

Другое · 7 мин

Произвольная форма в 1С: создание и настройка

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

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

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

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

Когда произвольная форма оправдана

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

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

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

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

В конфигураторе создайте новую форму, укажите её тип и основной объект, если форма привязана к справочнику, документу или обработке. Для независимой формы выберите тип «Форма» без привязки к объекту или настройте форму команды.

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

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

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

Элементы управления и модуль формы

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

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

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

Открытие формы и передача параметров

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

Маршрут решения

Как выбрать действие

Нужно открыть форму из списка справочникаДобавьте команду в форму списка и вызовите ОткрытьФорму с ссылкой на выбранный объект
Нужно независимый диалог с параметрамиСоздайте форму обработки и открывайте её из общего модуля или внешней команды
Нужно редактировать документИспользуйте стандартную форму документа вместо произвольной, если она покрывает задачу

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

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

Права, клиенты и ограничения

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

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

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

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

Форма открывается под обычным пользователем
Норма

Открывается без ошибок и с нужными правами

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

Ошибка прав или форма недоступна

Кнопка и команда работают
Норма

Выполняется ожидаемое действие

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

Ничего не происходит или возникает ошибка модуля

Параметры передаются корректно
Норма

Поля заполняются переданными значениями

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

Поля пустые или содержат чужие данные

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

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

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

Типичные ошибки
01
Правка формы в рабочей базе без резервной копии и тестирования
02
Перенос формы отдельным файлом без обновления конфигурации
03
Хранение важных данных только в реквизитах формы

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

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

Итог

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

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

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

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

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

Отличается ли форма в веб-клиенте от толстого клиента?

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

Как передать данные в форму при открытии?

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

Нужно ли обновлять информационную базу после изменения формы?

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

Может ли произвольная форма заменить документ или справочник?

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