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

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

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

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

Подготовка окружения и анализ требований

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

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

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

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

Навигация в дереве метаданных и выбор объекта

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

Раскройте узел выбранного документа. Внутри вы увидите несколько вложенных элементов: Реквизиты (шапка документа), Табличные части и Формы. Нас интересует именно раздел табличных частей. Если в документе несколько табличных частей (например, "Товары" и "Услуги"), определите, в какую именно нужно внести изменения. Обычно это основная часть, содержащая номенклатуру.

Выделите нужную табличную часть в дереве метаданных. В окне свойств (обычно находится внизу или справа, можно вызвать клавишей Alt+Enter) проверьте её имя и синоним. Это важно для понимания контекста. Далее, не закрывая свойства табличной части, найдите в её структуре вложенный элемент Реквизиты. Именно сюда будут добавляться новые колонки.

Нажмите правой кнопкой мыши на ветку Реквизиты внутри выбранной табличной части. В контекстном меню выберите пункт Добавить. Система создаст новый элемент с временным именем, например, НовыйРеквизит1. Теперь можно приступать к его настройке и переименованию в соответствии с задачами бизнеса.

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

После добавления нового элемента откройте его свойства. Первым делом измените Имя на понятное и латиницей, без пробелов и специальных символов, кроме подчеркивания. Например, СерийныйНомерСтроки или КомментарийКСтроке. Заполните поле Синоним — это название, которое будет видеть пользователь в интерфейсе программы, например, "Серийный номер" или "Примечание".

Самый важный этап — выбор типа данных. Нажмите на кнопку выбора типа рядом с полем Тип. В открывшемся окне выберите нужный тип. Если это текст, выберите Строка и укажите длину (например, 150 символов). Если это число, выберите Число и настройте длину и точность (количество знаков после запятой). Для ссылок на другие объекты (справочники, документы) выберите тип Ссылка и укажите конкретный вид объекта.

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

Тип данных	Пример использования	Рекомендуемая длина/точность
Строка	Комментарий, Артикул поставщика	50 - 250 символов
Число	Коэффициент, Скидка в строке	15 знаков, 4 знака после запятой
Дата	Дата производства в строке	Дата (без времени) или ДатаВремя
Булево	Флаг "Новинка", "Под заказ"	Не применимо

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

Отображение реквизита в форме документа

Само по себе создание реквизита в метаданных не добавляет его на экран пользователя. Чтобы новое поле стало доступно для ввода, его необходимо разместить на форме документа. В дереве метаданных найдите ветку Формы внутри вашего документа. Обычно там есть форма с названием ФормаДокумента или ОсновнаяФорма.

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

Чтобы добавить новую колонку, можно воспользоваться двумя способами. Первый: нажать правой кнопкой мыши на элемент Таблица, выбрать Добавить -> Поле таблицы. В свойствах нового поля в поле Поле формы выберите из списка ваш новый реквизит, созданный ранее. Второй способ: просто перетащить реквизит из дерева метаданных (или из палитры полей) прямо на таблицу в визуальном редакторе.

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

Доработка модуля объекта и проведение документов

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

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

Процедура ОбработкаПроведения(Отказ, Режим)
Для Каждого СтрокаТовары Из Товары Цикл
// Пример использования нового реквизита "КомментарийКСтроке"
Если СтрокаТовары.КомментарийКСтроке = "Брак" Тогда
// Логика обработки бракованного товара
Продолжить;
КонецЕсли;
КонецЦикла;
КонецПроцедуры

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

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

Как обратиться к реквизиту в запросе?

В тексте запроса к табличной части документа, реквизиты доступны напрямую по имени. Пример: ВЫБРАТЬ РеализацияТоваровУслуг.Товары.СерийныйНомер ИЗ Документ.РеализацияТоваровУслуг.Товары КАК Товары

Выгрузка изменений и обновление базы данных

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

Подтвердите действие. Запустится процесс обновления структуры базы данных. В ходе этого процесса 1С создаст новые колонки в таблицах SQL (если используется СУБД) или расширит файлы данных. Если в табличной части уже были записи, новые поля будут заполнены значениями по умолчанию или пустыми значениями, в зависимости от типа.

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

Частые вопросы и решение проблем

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

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

Можно ли удалить добавленный реквизит, если он больше не нужен?

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

Почему новый реквизит не виден в старых документах?

Новые реквизиты добавляются ко всем записям, но в старых документах они будут пустыми (или иметь значение по умолчанию), так как при их создании этого поля еще не существовало. Это нормальное поведение системы. Заполнять их задним числом можно только через специальную обработку обновления данных.

Как добавить реквизит, если база на SQL и доступ к конфигуратору ограничен?

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

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

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