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