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