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

Другое · 7 мин

Добавление дополнительного реквизита в документ 1С

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

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

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

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

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

Когда дополнительный реквизит нужен, а когда достаточно стандартного

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

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

Способ через изменение конфигурации документа

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

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

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

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

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

Механизм дополнительных реквизитов и сведений

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

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

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

Формы, печать и права доступа

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

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

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

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

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

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

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

Отображение поля на форме документа
Норма

Поле видно, доступно для редактирования и сохраняет значение

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

Поле отсутствует, недоступно или значение не сохраняется

Работа в печатных формах и отчётах
Норма

Значение выводится корректно и участвует в отборе

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

Значение пустое или не подставляется в отчёт

Права пользователей
Норма

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

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

Пользователи получают отказ в доступе или не видят поле

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

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

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

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

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

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

Итог

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

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

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

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

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

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

Почему новое поле может не отображаться на форме?

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

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

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

Нужно ли изменять печатную форму после добавления реквизита?

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