К статье
Практический материал

Другое · 6 мин

Таблица значений в 1С: создание и работа с данными

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

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

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

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

Когда таблица значений подходит, а когда нет

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

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

Порядок создания таблицы значений
  1. 1
    Объявите переменную типа ТаблицаЗначений и создайте объект через Новый ТаблицаЗначений().
  2. 2
    Добавьте нужные колонки через Колонки.Добавить("Имя").
  3. 3
    Создайте строки методом Строки.Добавить() и заполните ячейки по именам колонок.
  4. 4
    Проверьте количество строк и доступ к значениям перед использованием.

Создание и настройка колонок

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

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

Заполнение строк и доступ к данным

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

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

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

Частые ошибки и ограничения

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

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

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

Типичные ошибки
01
Обращение к отсутствующей строке по индексу вызывает ошибку выполнения.
02
Добавление колонок после заполнения строк не заполняет старые ячейки значениями по умолчанию.
03
Очистка таблицы при активных ссылках из других модулей ломает зависимости.

Проверка результата и альтернативы

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

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

Итог

Что важно запомнить

Таблица значений создается программно, заполняется строками и колонками, работает в памяти и не сохраняется в базе автоматически.

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

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

Чем таблица значений отличается от табличной части документа?

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

Как обратиться к ячейке таблицы значений?

Обращение выполняется по номеру строки и имени колонки, например ТаблицаЗначений[0].Номенклатура, или через ссылку на новую строку, полученную при добавлении. Перед обращением полезно проверить, что строка с таким индексом существует.

Что делать, если возникает ошибка при обращении к строке?

Проверьте свойство Количествострок: индекс должен быть меньше количества строк и не отрицательным. Убедитесь, что таблица не была очищена и ссылка на неё осталась действительной в текущем модуле.

Можно ли выгрузить таблицу значений в файл?

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