Таблица в 1С: как создать и работать с ней

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

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

Материал ориентирован на платформу 1С:Предприятие 8.3 и подходит для типовых и самописных конфигураций. Для выполнения примеров потребуется доступ к конфигуратору или хотя бы к внешней обработке с возможностью выполнения кода.

Что именно вы хотите создать: выбираем тип таблицы

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

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

Табличная часть — это уже элемент конфигурации: она создаётся в конфигураторе в составе справочника или документа и хранится в базе данных. Если задача — добавить в документ список строк (товары, услуги, сотрудники), нужна именно она.

Как создать таблицу значений программно

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

Типичный код создания и заполнения выглядит так:

ТЗ = Новый ТаблицаЗначений;
ТЗ.Колонки.Добавить("Номенклатура", Новый ОписаниеТипов("СправочникСсылка.Номенклатура"));
ТЗ.Колонки.Добавить("Количество", Новый ОписаниеТипов("Число"));
ТЗ.Колонки.Добавить("Цена", Новый ОписаниеТипов("Число"));

НоваяСтрока = ТЗ.Добавить();
НоваяСтрока.Номенклатура = СсылкаНаТовар;
НоваяСтрока.Количество = 5;
НоваяСтрока.Цена = 1200;

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

Если данные уже есть в базе, таблицу значений удобнее получить запросом: метод Запрос.Выполнить().Выгрузить() вернёт готовую таблицу значений с колонками по полям запроса. Это самый быстрый способ получить типизированную таблицу без ручного описания колонок.

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

Основные операции с таблицей значений

После заполнения таблица значений поддерживает типовые операции обработки. Метод Свернуть("Номенклатура", "Количество") группирует строки по указанным колонкам и суммирует числовые поля — аналог группировки в запросе. Метод Сортировать("Цена Убыв") упорядочивает строки, а Найти(Значение, "Колонка") возвращает первую подходящую строку.

Для множественного поиска используется НайтиСтроки(СтруктураОтбора), который возвращает массив строк. Удалить строки можно методом Удалить(Строка), очистить всю таблицу — Очистить(). Итог по числовой колонке считается методом Итог("Количество").

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

Как создать табличный документ для вывода данных

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

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

ТабДок = Новый ТабличныйДокумент;
Макет = ПолучитьМакет("МакетРеестра");
ОбластьШапка = Макет.ПолучитьОбласть("Шапка");
ТабДок.Вывести(ОбластьШапка);

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

ТабДок.Показать("Реестр");

Метод Показать() открывает документ пользователю в отдельном окне. Если нужна печать без показа, используйте ТабДок.Напечатать(), а для сохранения в файл — ТабДок.Записать(ИмяФайла, ТипФайлаТабличногоДокумента.XLSX).

1. 1
   Создайте макет типа Табличный документ в конфигураторе
2. 2
   Нарисуйте области: шапка, строка данных, подвал
3. 3
   Задайте параметры в ячейках, куда подставляются данные
4. 4
   В коде создайте объект Новый ТабличныйДокумент
5. 5
   Получайте области макета, заполняйте параметры и выводите в документ
6. 6
   Покажите результат методом Показать или сохраните в файл

Как добавить таблицу на форму обработки

Чтобы пользователь мог видеть и редактировать таблицу прямо на форме, в форме обработки или документа добавьте реквизит формы с типом «ТаблицаЗначений». В дереве реквизитов у него создайте подчинённые колонки с нужными типами: строка, число, ссылка на справочник.

Затем перетащите реквизит в дерево элементов формы — платформа автоматически создаст элемент «Таблица» с колонками. После этого работа в коде идёт с реквизитом формы как с обычной таблицей значений: Объект.Товары.Добавить() или, для реквизита формы, через методы коллекции данных формы.

Обратите внимание на нюанс управляемых форм: на клиенте таблица значений недоступна, работа идёт через объект «ДанныеФормыТаблица». Для массовой загрузки данных используйте серверные процедуры и передавайте готовую таблицу через ЗначениеВДанныеФормы.

Типичные ошибки при создании таблиц в 1С

Самая частая ошибка — добавление колонок без указания типа. Такая колонка принимает значения любого типа, из-за чего сортировка чисел может идти как сортировка строк («10» раньше «2»), а метод Свернуть не суммирует значения. Всегда задавайте ОписаниеТипов явно.

Вторая группа ошибок связана с табличным документом: обращение к параметру, которого нет в области, вызывает ошибку выполнения. Проверяйте, что имя параметра в макете совпадает с именем в коде с точностью до регистра и буквы «ё».

Третья типичная проблема — попытка использовать таблицу значений на клиенте в управляемой форме. Код Новый ТаблицаЗначений в клиентской процедуре завершится ошибкой: переносите создание и заполнение таблицы в серверную процедуру.

Как проверить результат

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

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

Частые вопросы