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