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

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

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

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

Выбор метода расширения: прямой реквизит или дополнительные сведения

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

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

Рассмотрим преимущества каждого подхода более детально:

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

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

Добавление реквизита в режиме Конфигуратора

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

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

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

После создания реквизита его нужно отобразить на форме. Откройте форму документа (обычно ФормаДокумента или ФормаОбъекта). Найдите новую переменную в списке реквизитов формы и перетащите её на макет в нужное место. Сохраните изменения и обновите конфигурацию базы данных через меню Конфигурация → Обновить конфигурацию базы данных.

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

Механизм Дополнительные реквизиты и сведения (ДРС) позволяет добавлять поля динамически. Для его использования в свойствах объекта метаданных (справочника или документа) должна быть установлена галочка Использовать дополнительные реквизиты и сведения. Эта опция активирует соответствующие подсистемы и регистры сведений.

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

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

Параметр	Дополнительные реквизиты	Дополнительные сведения
Хранение данных	В таблице объекта (или отдельной таблице ДРС)	В регистре сведений
Периодичность	Нет (непериодические)	Поддерживается (независимая, подчиненная)
Производительность	Высокая при прямых запросах	Требует соединения с регистром
Гибкость	Средняя	Высокая

Работа с расширениями конфигурации

В современных версиях 1С (8.3.10 и выше) рекомендуется использовать Расширения конфигурации вместо прямого изменения типовых объектов. Это позволяет добавлять реквизиты, не снимая поддержку конфигурации. Вы создаете расширение, добавляете в него новый реквизит к объекту-расширяемому и публикуете изменения.

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

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

⚠️ Внимание: При обновлении типовой конфигурации расширения могут конфликтовать с новыми объектами. Всегда тестируйте работу расширений на копии базы перед применением на продуктивном сервере.

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

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

Отображение реквизита в печатных формах и отчетах

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

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

ДопРеквизиты = Объект.ПолучитьДополнительныеРеквизиты();
Для каждого ДопРеквизит Из ДопРеквизиты Цикл
Если ДопРеквизит.Имя = "НомерДоговораПоставщика" Тогда
Макет.Область.НомерДоговора = ДопРеквизит.Значение;
КонецЕсли;
КонецЦикла;

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

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

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

Другая проблема — «потеря» данных при обновлении. Если вы изменили тип реквизита (например, увеличили длину строки), старые данные могут обрезаться или некорректно конвертироваться. Всегда делайте резервную копию базы перед изменением типов существующих полей.

• ❌ Ошибка проведения: Проверьте обработчики событий ПередЗаписью и ПередПроведением. Возможно, там есть жесткая проверка типа, которая блокирует сохранение.
• ❌ Дублирование имен: Убедитесь, что имя реквизита не совпадает с именами полей в связанных таблицах или временных хранилищах.
• ❌ Проблемы с правами: Новые реквизиты могут быть недоступны для некоторых ролей. Проверьте настройки прав доступа в режиме предприятия.

⚠️ Внимание: Интерфейс и точные названия пунктов меню могут отличаться в зависимости от версии платформы 1С:Предприятие (8.3.15, 8.3.20 и т.д.) и конкретной конфигурации (Бухгалтерия, УТ, ЗУП). Сверяйте названия с вашей версией.

FAQ: Вопросы и ответы

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

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

Как удалить добавленный реквизит?

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

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

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

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

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

Можно ли сделать доп. реквизит обязательным для заполнения?

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