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

Другое · 7 мин

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

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

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

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

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

H2 Когда собственная форма документа нужна

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

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

H2 Создание формы через Конфигуратор

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

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

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

H3 Форма документа и форма списка

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

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

H2 Настройка реквизитов и команд формы

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

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

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

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

Открытие карточки документа
Норма

Все нужные реквизиты видны и доступны

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

Поля отсутствуют или недоступны для редактирования

Запись и проведение документа
Норма

Документ сохраняется и проводится без ошибок

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

Появляются сообщения об ошибках или документ не записывается

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

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

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

Кнопки не реагируют или вызывают ошибки

H2 Программирование в модуле формы

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

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

H2 Проверка и публикация изменений

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

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

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

H2 Частые ошибки и ограничения

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

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

Итог

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

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

Нужно ли программирование для создания формы документа?

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

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

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

В чем разница между формой документа и формой списка?

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

Что проверить после создания формы?

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

Что делать, если форма не открывается у пользователя?

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