Добавление строки в динамический список 1С

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

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

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

Использование ТабличногоДокумента для формирования списков

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

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

• 📊 Используйте метод Вывести() для добавления подготовленной области в конец документа.
• 📝 Заполняйте значения ячеек через свойство Область.Параметры или прямой доступ к ячейкам.
• 🔄 Очищайте временные объекты перед циклом, чтобы избежать дублирования данных.

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

Работа с ТаблицейЗначений как основой списка

Часто под динамическим списком подразумевают объект ТаблицаЗначений, который затем передается в элемент формы или используется как источник данных для СКД. Это наиболее эффективный способ работы с большими объемами данных внутри кода. Добавление строки в такую таблицу выполняется методом Добавить().

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

⚠️ Внимание: Не пытайтесь добавить строку в таблицу значений, если она имеет жесткую структуру колонок, не соответствующую вашим данным. Сначала убедитесь, что колонки созданы через Колонки.Добавить().

Рассмотрим типичный сценарий. Вы создаете таблицу, добавляете в неё колонки, а затем в цикле наполняете строки. Код должен быть оптимизирован, чтобы не вызывать лишние пересчеты индексов. Если таблица значений используется как источник для элемента формы типа "Таблица", изменение структуры колонок после создания таблицы может привести к ошибкам отображения.

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

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

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

Настройка колонок и типов данных

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

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

Имя колонки	Рекомендуемый тип	Описание
Количество	Число(15, 3)	Дробное число с тремя знаками после запятой
ДатаОперации	Дата	Стандартная дата времени 1С
Комментарий	Строка(100)	Текстовое поле ограниченной длины
Сумма	Число(15, 2)	Денежная сумма, два знака после запятой

Если вы работаете со ссылкой на объект базы данных (например, Справочник.Номенклатура), тип колонки должен соответствовать типу ссылки. Использование универсального типа УниверсальнаяКоллекция возможно, но затрудняет дальнейшую обработку данных и построение запросов по этой таблице.

Как изменить тип существующей колонки?

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

Добавление строк через запрос и СКД

В современных конфигурациях, таких как Бухгалтерия Предприятия или Управление Торговлей, динамические списки часто формируются с помощью Схемы Компоновки Данных (СКД). В этом случае вы не добавляете строки вручную в цикле, а формируете набор данных, который СКД превращает в список.

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

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

• ⚙️ Передавайте таблицу значений в свойство ИсточникДанных схемы компоновки.
• 📂 Используйте виртуальные таблицы для оптимизации SQL-запросов при больших объемах.
• 🎨 Настраивайте поля вывода через объект Настройки для гибкого отображения.

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

Обработка событий и интерактивность списка

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

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

⚠️ Внимание: Изменение структуры таблицы значений (добавление колонок) во время работы формы может привести к сбросу настроек пользователя. Делайте это только при инициализации формы.

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

Очистка и управление памятью динамических списков

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

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

Для объектов типа ТабличныйДокумент также полезно использовать метод АвтоРазмер() после заполнения, чтобы интерфейс корректно отобразил содержимое без лишней пустой области внизу. Правильное управление жизненным циклом объектов — признак качественного кода в 1С.

ℹ️ Примечание: Интерфейс и методы работы с отчетами могут отличаться в разных версиях платформы 1С (8.2, 8.3, 8.3.20+). Всегда сверяйте синтаксис методов в справке по вашей конкретной версии платформы, так как некоторые устаревшие методы могут быть помечены как нерекомендуемые.

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

Как добавить строку в начало таблицы значений, а не в конец?

Метод Добавить() всегда добавляет строку в конец. Чтобы вставить строку в начало или в середину, используйте метод Вставить(Индекс). Например, ТЗ.Вставить(0) создаст новую строку с индексом 0, сдвинув остальные вниз.

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

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

Почему не отображается добавленная строка в форме?

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

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

Используйте метод ЗагрузитьКолонки() для копирования структуры, а затем метод ВыгрузитьКолонки() или простой цикл для переноса данных. Самый быстрый способ — Таблица2.ЗагрузитьКолонки(Таблица1.ВыгрузитьКолонки()), если структуры совместимы.

Влияет ли добавление строк на производительность 1С?

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