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