Как добавить реквизит в документ 1С: полное руководство

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

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

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

Подготовка окружения и открытие конфигурации

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

Запустите платформу и выберите режим запуска «Конфигуратор». В открывшемся окне дерева метаданных найдите ветку «Документы». Именно здесь хранятся определения всех видов документов, используемых в вашей системе. Раскройте список и выберите тот объект, в который планируется внедрение нового поля.

⚠️ Внимание: Перед внесением изменений обязательно создайте резервную копию базы данных (файл .dt или бэкап SQL). Откатить изменения структуры метаданных после обновления конфигурации базы данных практически невозможно без потери введенных пользователями данных за период между бэкапами.

Дважды кликните по названию документа, чтобы открыть его форму редактирования. Вы увидите несколько вкладок: «Основные», «Движения», «Реквизиты» и другие. Нас интересует именно вкладка Реквизиты, где определяется структура хранения данных. Здесь уже присутствуют стандартные поля, такие как «Номер», «Дата» и «Организация».

Создание нового реквизита в структуре документа

Находясь во вкладке «Реквизиты», нажмите кнопку добавления нового элемента (обычно это значок с плюсиком или клавиша Insert). Система предложит ввести имя нового поля. Имя реквизита должно быть уникальным в пределах объекта и не должно содержать пробелов или спецсимволов, допустимы только латинские буквы, цифры и знак подчеркивания.

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

Тип данных	Описание	Пример использования
Строка	Текстовое поле произвольной длины	Комментарий менеджера, номер заказа поставщика
Число	Числовое значение с заданной точностью	Коэффициент скидки, вес брутто, этажность
Дата	Дата и время события	Дата фактической отгрузки, срок гарантии
СправочникСсылка	Ссылка на элемент другого справочника	Ответственный менеджер, склад отгрузки

Если вы выбираете составной тип, например, «Строка» и «Число», система позволит пользователю вводить данные любого из указанных форматов. Однако для аналитики и отчетов лучше использовать атомарные типы. Заполните также поле «Синоним» — это название, которое будет видеть пользователь в интерфейсе, оно может быть на русском языке и содержать пробелы.

Настройка свойств и ограничений ввода

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

Особое внимание уделите галочке «Использовать» и «Включать в итог». Первая делает поле доступным для записи, а вторая позволяет использовать его в отчетах как измерение или ресурс. Если вы планируете выводить этот показатель в печатные формы или отчеты, галочка «Включать в итог» обязательна.

Для справочников и документов можно настроить список выбора. Если тип реквизита — «СправочникСсылка», укажите, какой именно справочник должен открываться при нажатии кнопки выбора. Это исключит ошибки пользователей, которые могут попытаться выбрать некорректный объект из общего списка.

⚠️ Внимание: Изменение типа существующего реквизита (например, со Строки на Число) приведет к потере данных или ошибке конвертации базы. Если тип нужно изменить, создайте новый реквизит, перенесите данные программно, а старый пометьте на удаление.

Также стоит проверить свойство «Проверка заполнения». Если поле является обязательным для заполнения, установите соответствующий флаг. Система не позволит пользователю провести документ, пока в этом поле не будет введено значение. Это мощный инструмент контроля качества ввода первичной документации.

Вывод реквизита на форму документа

Создание поля в метаданных — это только половина дела. Чтобы пользователь мог работать с новым реквизитом, его необходимо разместить на форме. Перейдите на вкладку «Формы» объекта документа и откройте основную форму (обычно она называется «ФормаДокумента» или «Основная форма»). Откроется редактор форм.

В левой части редактора вы увидите дерево элементов формы. Найдите группу «Реквизиты» или аналогичную, где перечислены все поля документа. Ваш новый реквизит должен отображаться в этом списке. Перетащите его мышкой на визуальную часть формы в правой панели, расположив в нужном месте (например, в шапке или в табличной части).

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

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

Интеграция в печатные формы и отчеты

Часто новые данные нужны не только для ввода, но и для печати на бумажных носителях. Для этого необходимо отредактировать макет печатной формы. В дереве метаданных документа найдите раздел «Макеты» и откройте нужный шаблон (например, «ПечатнаяФорма» или внешний макет).

В редакторе табличного документа или HTML-шаблона добавьте новую ячейку в нужное место. Присвойте этой ячейке имя поля, соответствующее имени вашего реквизита в коде. Синтаксис зависит от используемого механизма печати, но часто используется конструкция вида &РеквизитИмяПоля или прямое обращение через объект документа.

Если вы используете управляемые формы и СКД (Систему Компоновки Данных) для отчетов, добавьте новое поле в набор данных. В конструкторе запроса выберите ваш документ и отметьте галочкой новый реквизит. Теперь он станет доступен для размещения в макете отчета.

Проблемы с выводом в старых версиях

В старых версиях платформы (до 8.2) вывод динамических списков мог требовать ручной доработки модуля объекта. В современных версиях (8.3.10+) достаточно добавить поле в макет, если используется стандартный механизм печати.

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

Обработка данных в модуле объекта

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

Наиболее часто используемые события — ПередЗаписью и ОбработкаПроведения. В процедуре ПередЗаписью можно реализовать автоматическое заполнение реквизита на основе других данных или проверку условий. Например, если выбрана определенная номенклатура, поле «Срок годности» может заполняться автоматически.

Процедура ПередЗаписью(Отказ, РежимЗаписи, РежимПроведения)
Если ЭтотОбъект.ВидОперации = Перечисления.ВидыОпераций.Розница Тогда
ЭтотОбъект.НашРеквизит = "Розничная продажа";
КонецЕсли;
КонецПроцедуры

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

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

Частые ошибки и способы их решения

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

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

• 🔴 Ошибка типа данных: Попытка записать текст в числовое поле вызовет исключение. Проверяйте типы в коде.
• 🔴 Конфликт имен: Имя реквизита совпадает с системным полем или полем другой таблицы. Используйте уникальные префиксы.
• 🔴 Проблема с обновлением: При обновлении типовой конфигурации ваши изменения могут быть затерты. Используйте механизмы расширения конфигурации.

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

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

В типовых конфигурациях с заблокированным режимом конфигуратора (например, на 1С:Фреш) это невозможно напрямую. Необходимо использовать механизм «Расширения конфигурации», который позволяет добавлять новые поля и формы поверх основной конфигурации без снятия с поддержки.

Влияет ли добавление реквизита на скорость работы базы?

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

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

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

Как перенести добавленный реквизит на другую базу?

Простое копирование файла конфигурации (.cf) перенесет структуру. Если базы уже наполнены данными, потребуется выгрузка и загрузка конфигурации с обновлением базы данных. Для переноса только одного реквизита в сложной системе удобнее использовать обработку выгрузки/загрузки объектов метаданных или механизмы расширений.