Программное добавление колонки в табличную часть на форме 1С

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

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

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

Архитектура формы и табличные части

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

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

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

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

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

Подготовка реквизитов формы

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

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

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

Процедура ПриСозданииНаСервере(Отказ, СтандартнаяОбработка)
// Получаем описание типа Булево
ТипБулево = Новый ОписаниеТипов("Булево");

// Добавляем реквизит в табличную часть "Товары"
// "Выбран" - имя нового поля
Форма.РеквизитыТабличнойЧастиФормы.Товары.Добавить("Выбран", ТипБулево);

// Инициализируем значения для существующих строк
Для Каждого СтрокаТовара Из Форма.Товары Цикл
СтрокаТовара.Выбран = Ложь;
КонецЦикла;
КонецПроцедуры

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

Программное создание колонки в макете

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

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

Метод Колонки.Добавить возвращает ссылку на созданный объект колонки, что позволяет сразу же настроить её свойства. Вы можете задать заголовок, ширину, выравнивание и другие параметры. Это дает возможность адаптировать интерфейс под конкретные задачи пользователя без создания множества вариантов форм в конфигураторе.

Процедура ДобавитьКолонкуВыбора()
// Получаем ссылку на табличное поле
ТабПоле = Элементы.Товары;

// Добавляем колонку, указывая путь к данным
НоваяКолонка = ТабПоле.Колонки.Добавить("Товары.Выбран");

// Настраиваем свойства колонки
НоваяКолонка.Заголовок = "Отметка";
НоваяКолонка.Ширина = 3;
НоваяКолонка.ГоризонтальноеПоложение = Центр;
КонецПроцедуры

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

Нюансы работы с динамическими списками

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

Настройка свойств и видимости элементов

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

Управление видимостью осуществляется через свойство Видимость. Это логическое значение, которое можно изменять динамически в ответ на действия пользователя. Частая задача — показывать дополнительные колонки только при включенном режиме "Расширенный" или для пользователей с определенными правами доступа. Изменение видимости не удаляет колонку, а лишь скрывает её с экрана.

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

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

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

Обработка событий и взаимодействие с данными

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

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

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

Процедура ТоварыВыбранПриИзменении(Элемент)
// Получаем текущую строку
ТекущаяСтрока = Элементы.Товары.ТекущиеДанные;

Если ТекущаяСтрока.Выбран Тогда
// Логика при установке флага
Сообщить("Строка выбрана: " + ТекущаяСтрока.Номенклатура);
Иначе
// Логика при снятии флага
КонецЕсли;

// Вызываем серверную процедуру для пересчета
ПересчитатьИтогиНаСервере();
КонецПроцедуры

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

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

Сохранение настроек и восстановление состояния

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

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

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

Также стоит предусмотреть сброс настроек к заводским. Пользователь может случайно добавить лишние поля или нарушить структуру таблицы так, что работа станет невозможной. Кнопка "Сбросить настройки" должна очищать сохраненные параметры и инициировать создание формы в базовом состоянии, определенном разработчиком.

Частые ошибки и отладка

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

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

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

Почему колонка добавляется, но данные в ней не сохраняются?

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

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

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

Как удалить программно добавленную колонку?

Используйте метод Удалить коллекции колонок табличного поля. Пример: Элементы.Товары.Колонки.Удалить("Товары.Выбран"). Не забудьте также удалить соответствующий реквизит из коллекции реквизитов формы, если он больше не нужен.

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

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