Другое · 6 мин
Таблица значений 1С: создание, заполнение и проверка
Пошаговая статья о создании таблицы значений в 1С: добавление колонок, строк, чтение данных, отличия от табличного документа и типичные ошибки.
Таблица значений в 1С — это объект встроенного языка, предназначенный для временного хранения набора строк с одинаковой структурой в оперативной памяти. Она используется, когда нужно собрать данные из разных источников, подготовить их для отчёта, обмена или обработки, а затем пройтись по строкам построчно.
В отличие от таблицы базы данных, таблица значений не сохраняется постоянно: она существует только в рамках сеанса, пока не будет выгружена или очищена. Создаётся и наполняется исключительно программно, через конструктор в интерфейсе пользователя добавить строки в такую таблицу нельзя.
Что такое таблица значений и где она применяется
Таблица значений подходит для промежуточных расчётов, когда данные нужно собрать из регистров, документов или справочников, привести к общему виду и передать дальше в печатную форму или обработку. Она удобна, если структура набора заранее известна, а количество строк может меняться в процессе выполнения.
Основные сценарии: формирование выборки для отчёта, подготовка данных к выгрузке, сравнение двух наборов по одинаковым ключам, накопление результатов в цикле. Если данные нужны только для вывода на печать, чаще целесообразнее использовать табличный документ, а не таблицу значений.
Как создать таблицу значений в коде 1С
Создание начинается с объявления объекта и добавления колонок. Без колонок таблица не может содержать строк, поэтому порядок действий важен: сначала объект, потом колонки, потом строки и только после этого значения.
- 1Создать объект: Новый ТаблицаЗначений
- 2Добавить нужные колонки через Колонки.Добавить
- 3Добавить строки через Добавить()
- 4Записать значения в ячейки по имени или индексу колонки
- 5Проверить, что таблица содержит ожидаемые строки
Создание пустой таблицы и добавление колонок
Пустая таблица создаётся одной командой, но без колонок она бесполезна. Каждая колонка получает имя, по которому позже обращаются к ячейкам. Имена колонок должны быть уникальными в пределах одной таблицы.
Добавление строк и заполнение ячеек
После добавления колонок вызывается метод добавления строки. Новая строка изначально пустая, и значения в неё записываются поочерёдно. Обращение к ячейке возможно как по имени колонки, так и по её порядковому номеру, что удобно при динамическом формировании структуры.
Таблица = Новый ТаблицаЗначений; Таблица.Колонки.Добавить("Контрагент"); Таблица.Колонки.Добавить("Сумма"); Строка = Таблица.Добавить(); Строка.Контрагент = Контрагент; Строка.Сумма = 100;Как читать и использовать данные из таблицы
Чтение выполняется в цикле по строкам таблицы. Количество строк определяется свойством Количествострок, а обращение к конкретной строке — по индексу начиная с нуля. Значения извлекаются по именам колонок и могут использоваться в расчётах, условиях или передаваться в другие процедуры.
Если таблица используется для передачи данных между формами или модулями, Изменения в одной части программы будут видны и в другой, если не создана явная копия таблицы.
Отличие от табличного документа и ограничения
Таблица значений часто путают с табличным документом. Первый хранит данные в памяти для логики и расчётов, второй предназначен для оформления и вывода на печать. У табличного документа есть области, стили и настройки печати, у таблицы значений — только строки и колонки без оформления.
Ограничение таблицы значений — отсутствие встроенного поиска по индексам и сложность работы с очень большими объёмами. Для постоянного хранения используются регистры, справочники и документы, а таблица значений остаётся вспомогательным инструментом внутри одной задачи.
Как проверить результат
Колонки добавлены, таблица принимает строки
Попытка добавить строку без колонок вызывает ошибку
Соответствует ожидаемому числу записей
Ноль строк или меньше, чем запланировано
Как проверить результат и избежать ошибок
После заполнения стоит убедиться, что каждая строка содержит ожидаемые значения в нужных колонках. Простейшая проверка — вывод количества строк и содержимого первой и последней строки в отладочную информацию. Это помогает выявить ситуацию, когда данные не записались из-за опечатки в имени колонки.
Частая ошибка — обращение к колонке, которая не была добавлена, или к строке, которая не существует. Такая ошибка приводит к прерыванию выполнения, поэтому перед доступом к ячейке полезно проверять наличие колонки и допустимый диапазон индексов строк.
Частые ситуации и альтернативы
Если нужно просто распечатать отчёт, выбирайте табличный документ. Если данные должны остаться после завершения работы программы, используйте справочники, документы или регистры накопления. Таблица значений оправдана, когда нужна быстрая временная коллекция внутри одной обработки или отчёта.
При передаче таблицы значений в качестве параметра процедуры помните, что изменения внутри процедуры отразятся на исходном объекте. Если это нежелательно, создавайте копию перед передачей или работайте с отдельным экземпляром таблицы.
Что важно запомнить
Таблица значений создаётся и заполняется только в коде, существует во время сеанса и подходит для временных расчётов, а не для постоянного хранения.
Нужно ли создавать таблицу значений через интерфейс пользователя?
Нет, таблица значений не создаётся через обычную форму или конструктор интерфейса. Она программный объект, который описывается и наполняется в коде модуля.
Можно ли использовать таблицу значений для печати отчёта?
Технически данные из таблицы можно вывести на печать, но для оформления лучше использовать табличный документ. Таблица значений не содержит инструментов для настройки макета, стилей и областей печати.
Что произойдёт с данными после завершения сеанса?
Содержимое таблицы значений хранится в оперативной памяти и исчезает при завершении работы или выгрузке объекта. Для постоянного сохранения нужно перенести данные в справочник, документ, регистр или выгрузить во внешний файл.
Как проверить, что таблица заполнена правильно?
Проверьте количество строк, наличие всех ожидаемых колонок и значения в первой и последней строке. Также убедитесь, что обращение к колонкам ведётся по точным именам, указанным при создании.
В чем разница между таблицей значений и табличным документом?
Таблица значений служит для хранения и обработки данных в памяти, табличный документ — для оформления и вывода на печать. У табличного документа есть настройки макета и стилей, у таблицы значений — только структура колонок и строк.