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

Другое · 7 мин

Форма документа в 1С: что это и как с ней работать

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

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

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

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

Что такое форма документа в 1С

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

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

Из чего состоит форма документа

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

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

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

Как открыть и осмотреть форму документа

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

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

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

Стандартная и изменённая форма

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

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

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

Проверка результата и безопасные границы

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

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

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

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

Открытие документа в рабочем интерфейсе
Норма

Все нужные поля и команды отображаются, документ записывается без ошибок

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

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

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

Частые ошибки и альтернативы

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

Типичные ошибки
01
Редактирование стандартной формы напрямую вместо использования расширения конфигурации
02
Забыть проверить форму в тонком и веб-клиенте после изменения расположения полей
03
Удалить обязательный реквизит с формы, что приведёт к ошибкам при записи документа

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

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

Итог

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

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

Часто задаваемые вопросы

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

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

Чем форма документа отличается от самого документа?

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

Будут ли сохранены изменения формы после обновления конфигурации?

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

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

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