Добавление колонки в табличную часть 1С

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

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

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

Анализ структуры метаданных и выбор объекта

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

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

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

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

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

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

Нажмите правой кнопкой мыши на название табличной части и выберите пункт Добавить -> Реквизит. В открывшемся окне свойств задайте уникальное имя для новой колонки. Имя должно быть написано латиницей, без пробелов и специальных символов, например, СерийныйНомер или КомментарийСтроки. Это имя будет использоваться в коде модулей и запросах.

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

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

Настройка свойств и типов данных

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

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

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

Тип данных	Пример использования	Особенности хранения
Строка	Комментарий, Артикул	Требует указания длины (до 255 символов)
Число	Вес, Объем, Коэффициент	Важна точность и масштаб дробной части
Булево	Флаг "Подарок", "Новинка"	Хранится как 0 или 1, удобно для фильтров
Дата	Дата гарантийного срока	Может хранить только дату или время с датой

Как изменить тип существующего реквизита?

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

Вывод колонки в форму документа и списка

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

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

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

⚠️ Внимание: Если вы используете управляемые формы, изменения в макете формы могут не примениться мгновенно для всех пользователей. Требуется обновление форм на клиенте или перезапуск сеанса 1С.

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

Использование в отчетах и СКД

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

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

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

Программная обработка и обновление данных

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

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

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

Результат = Запрос.Выполнить();
Выборка = Результат.Выбрать();

Пока Выборка.Следующий() Цикл
Объект = Выборка.Ссылка.ПолучитьОбъект();
Для Каждого СтрокаТаблицы Из Объект.Товары Цикл
СтрокаТаблицы.НоваяКолонка = СтрокаТаблицы.Количество * 1.2;
КонецЦикла;
Объект.Записать();
КонецЦикла;

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

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

Часто задаваемые вопросы (FAQ)

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

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

Что делать, если после добавления колонки 1С выдает ошибку при запуске?

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

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

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

Влияет ли большое количество колонок на скорость работы 1С?

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