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

Другое · 6 мин

Создание общей формы в 1С: пошаговая инструкция

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

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

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

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

Что такое общая форма и где она применяется

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

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

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

Подготовка и требования к конфигурации

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

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

Создание общей формы в Конфигураторе

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

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

Порядок действий
  1. 1
    Открыть ветку «Общие формы» в Конфигураторе
  2. 2
    Создать новую общую форму и задать имя
  3. 3
    Настроить реквизиты, команды и модуль формы
  4. 4
    Сохранить конфигурацию и обновить базу
  5. 5
    Проверить вызов формы в режиме предприятия

Настройка атрибутов, команд и модуля формы

Реквизиты формы определяют, какие данные пользователь вводит или видит в диалоге. Команды добавляют действия, например «Выполнить», «Отмена» или «Заполнить». Для каждой команды пишется обработчик в модуле формы, где описан алгоритм действий.

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

Подключение формы к команде и вызов в режиме предприятия

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

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

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

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

Открытие формы по команде
Норма

Форма открывается без ошибок

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

Ошибка при открытии или форма пустая

Работа команд формы
Норма

Кнопки выполняют заданные действия

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

Нажатие не вызывает ожидаемого результата

Права доступа
Норма

Доступно ролям с нужными правами

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

Пользователь не видит команду или форму

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

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

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

Типичные ошибки
01
Попытка открыть общую форму как форму документа без объекта данных
02
Изменение типовой конфигурации без резервной копии и копии конфигурации
03
Забыть обновить конфигурацию в информационной базе после правок

Ограничения и альтернативы

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

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

Итог

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

Общая форма создаётся в Конфигураторе, настраивается в конструкторе форм, вызывается через команду и проверяется после обновления конфигурации и резервного копирования.

Нужно ли программирование для общей формы?

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

Может ли общая форма редактировать данные документа?

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

Что делать, если конфигурация защищена?

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

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

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