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

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

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

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

Подготовка реквизита формы для таблицы

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

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

Крайне важно сразу определить структуру будущей таблицы. Нажмите кнопку «Изменить» рядом с типом данных. В открывшемся окне конструктора типов добавьте необходимые колонки. Каждая колонка должна иметь имя, тип и длину.

• 📦 Колонка «Номенклатура»: тип СправочникСсылка.Номенклатура, обязательное заполнение.
• 🔢 Колонка «Количество»: тип Число, длина 15, точность 3.
• 💰 Колонка «Цена»: тип Число, длина 15, точность 2.
• 💵 Колонка «Сумма»: тип Число, рассчитываемое поле.

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

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

Размещение элемента «Табличное поле» на форме

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

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

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

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

Настройка визуального отображения и колонок

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

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

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

ЧГ(2); ЧН=0

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

Свойство колонки	Описание	Пример значения
Заголовок	Текст, видимый пользователю	Артикул товара
Ширина	Размер колонки в форме	100 пикселей
Редактирование	Возможность изменения ячейки	Только чтение
Видимость	Отображение колонки на экране	Ложь (скрыта)

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

Секрет быстрой настройки ширины

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

Программное заполнение таблицы значений

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

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

НоваяСтрока = Объект.СписокТоваров.Добавить;
НоваяСтрока.Номенклатура = ВыбранныйТовар;
НоваяСтрока.Количество = 10;
НоваяСтрока.Цена = 1500.00;
НоваяСтрока.Сумма = НоваяСтрока.Количество * НоваяСтрока.Цена;

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

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

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

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

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

Обработчик события размещается в модуле формы. Имя процедуры формируется автоматически: СписокТоваровКоличествоПриИзменении. Внутри процедуры вы обращаетесь к текущей строке через параметр ТекущиеДанные.

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

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

Динамическое управление списком колонок

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

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

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

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

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

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

Как сделать колонку таблицы только для чтения?

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

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

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

Почему данные в таблице не сохраняются после закрытия формы?

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

Как отсортировать строки в таблице на форме?

Используйте метод Сортировать у объекта таблицы значений. В параметрах укажите имя колонки и направление сортировки, например: Объект.СписокТоваров.Сортировать("Номенклатура Убыв").

Можно ли объединять ячейки в таблице 1С?

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