Как вставить строку в таблицу значений 1С: от простого к сложному

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

В этой статье мы разберём все актуальные способы вставки строк — от базовых действий в пользовательском режиме до продвинутых техник программирования. Особое внимание уделим типичным ошибкам, которые допускают даже опытные специалисты, и покажем, как их избежать. Материал будет полезен как начинающим 1С-никам, так и тем, кто хочет оптимизировать существующий код.

Все примеры тестировались на платформе 1С:Предприятие 8.3 (актуальные релизы), но большинство методов применимы и к более ранним версиям. Если вы работаете с управляемыми формами в тонком клиенте, некоторые подходы потребуют адаптации — об этом мы тоже упомянем.

1. Ручное добавление строк через интерфейс 1С

Самый простой способ вставить строку — сделать это непосредственно в интерфейсе программы. Этот метод не требует знания встроенного языка и доступен любому пользователю с соответствующими правами.

Чтобы добавить строку в таблицу значений через интерфейс:

• 📌 Откройте форму, содержащую таблицу значений (например, документ, отчёт или обработку).
• 🖱️ Кликните правой кнопкой мыши по таблице и выберите Добавить или нажмите Insert на клавиатуре.
• ✏️ Заполните ячейки новой строки необходимыми данными.
• 💾 Сохраните изменения (если это документ) или подтвердите ввод (в обработках).

Этот метод удобен для разовых операций, но имеет ограничения:

• ⚠️ Не подходит для массового добавления данных.
• ⚠️ Не позволяет автоматизировать процесс.
• ⚠️ В некоторых конфигурациях может быть отключён из-за настроек прав.

⚠️ Внимание: В тонком клиенте и веб-клиенте 1С некоторые комбинации клавиш (например, Insert) могут не работать. В этом случае используйте контекстное меню или кнопки панели инструментов.

2. Программное добавление строк методом Добавить()

Основной способ добавления строк в коде — использование метода Добавить() объекта ТаблицаЗначений. Этот метод создаёт новую строку и возвращает её для заполнения.

Базовый синтаксис:

Таблица = Новый ТаблицаЗначений;
НоваяСтрока = Таблица.Добавить();
НоваяСтрока.ИмяКолонки1 = Значение1;
НоваяСтрока.ИмяКолонки2 = Значение2;

Пример с заполнением:

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

// Добавляем строку и заполняем её
НовыйТовар = ТаблицаТоваров.Добавить();
НовыйТовар.Наименование = "Монитор 24\"";
НовыйТовар.Количество = 5;
НовыйТовар.Цена = 18500;

Особенности метода:

• 🔹 Возвращает ссылку на созданную строку, что позволяет сразу её заполнить.
• 🔹 Если таблица привязана к форме, изменения отобразятся после вызова Обновить().
• 🔹 В управляемых формах может потребоваться вызов ЭлементыФормы.ИмяТаблицы.Обновить().

3. Массовое добавление строк: оптимизация производительности

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

Способ 1: Заполнение через индексатор

Таблица = Новый ТаблицаЗначений;
// Добавляем колонки...
Для Сч = 1 По 100 Цикл
НоваяСтрока = Таблица.Добавить();
Таблица[Таблица.Количество()-1].Наименование = "Товар " + Сч;
Таблица[Таблица.Количество()-1].Цена = Сч * 100;
КонецЦикла;

Способ 2: Использование ЗагрузитьКолонку()

Если данные подготовлены в массиве, можно загрузить их сразу:

МассивНаименований = Новый Массив;
МассивЦен = Новый Массив;
// Заполняем массивы...
Таблица.ЗагрузитьКолонку("Наименование", МассивНаименований);
Таблица.ЗагрузитьКолонку("Цена", МассивЦен);

Способ 3: Копирование из другой таблицы

Источник = ПолучаемТаблицуИзБазы(); // Например, результат запроса
Приемник = Новый ТаблицаЗначений;
Приемник.КопироватьКолонки(Источник);
Приемник.КопироватьДанные(Источник);

⚠️ Внимание: При работе с очень большими таблицами (10 000+ строк) в тонком клиенте может возникнуть ошибка переполнения памяти. В таких случаях используйте серверные процедуры или разбивайте операции на пакеты по 1000-5000 строк.

4. Вставка строки в произвольную позицию

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

Таблица.Вставить(Индекс, НоваяСтрока);

Пример:

// Вставляем строку на вторую позицию (индекс 1)
НоваяСтрока = Таблица.Добавить(); // Создаём строку
Таблица.Вставить(1, НоваяСтрока); // Вставляем на второе место
НоваяСтрока.Наименование = "Вставленный товар";

Важные нюансы:

• 📍 Индексация начинается с 0 (первая строка — индекс 0).
• 🔄 Если указать индекс за пределами таблицы, строка будет добавлена в конец.
• 🔀 При вставке все строки после указанного индекса сдвигаются вправо.

Для вставки без создания новой строки (копирования существующей):

Таблица.Вставить(Индекс, Таблица[ИсточникИндекс]);

5. Добавление строк с проверкой уникальности

Частая задача — избежать дублирования данных при добавлении. Для этого можно использовать следующие подходы:

Способ 1: Проверка перед добавлением

Функция ДобавитьЕслиУникально(Таблица, ЗначениеКлюча, КолонкаКлюча)
Для Каждого Строка Из Таблица Цикл
Если Строка[КолонкаКлюча] = ЗначениеКлюча Тогда
Возврат Ложь; // Дубликат найден
КонецЕсли;
КонецЦикла;

НоваяСтрока = Таблица.Добавить();
НоваяСтрока[КолонкаКлюча] = ЗначениеКлюча;
Возврат Истина;
КонецФункции;

Способ 2: Использование НайтиСтроки()

КлючевыеДанные = Новый Структура("Код", "Товар123");
НайденныеСтроки = Таблица.НайтиСтроки(КлючевыеДанные);
Если НайденныеСтроки.Количество() = 0 Тогда
НоваяСтрока = Таблица.Добавить();
НоваяСтрока.Код = "Товар123";
КонецЕсли;

Способ 3: Индексы и быстрый поиск

Для крупных таблиц (>1000 строк) целесообразно создать индекс:

Таблица.Индексы.Добавить("ПоКоду");
Таблица.Индексы.ПоКоду.Добавить("Код");
Таблица.Индексы.ПоКоду.УстановитьТипИндекса(ТипИндексаТаблицыЗначений.Уникальный);

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

6. Работа с таблицами значений в управляемых формах

В управляемых формах добавление строк имеет особенности из-за клиент-серверной архитектуры. Основные правила:

1. Добавление на клиенте

&НаКлиенте
Процедура ДобавитьСтроку(Команда)
НоваяСтрока = ЭлементыФормы.ТаблицаТоваров.Добавить();
НоваяСтрока.Наименование = "Новый товар";
КонецПроцедуры

2. Добавление на сервере с обновлением формы

&НаСервере
Процедура ДобавитьСтрокуНаСервере()
ТаблицаОбъект = Объект.ТаблицаТоваров;
НоваяСтрока = ТаблицаОбъект.Добавить();
НоваяСтрока.Наименование = "Серверный товар";
КонецПроцедуры

&НаКлиенте
Процедура ПослеДобавленияНаСервере(Результат)
ЭлементыФормы.ТаблицаТоваров.Обновить();
КонецПроцедуры

Типичные ошибки в управляемых формах:

• 🚫 Прямое изменение таблицы на сервере без последующего Обновить() на клиенте.
• 🚫 Использование клиентских методов в серверных процедурах (например, обращение к ЭлементыФормы на сервере).
• 🚫 Забывают про ПометитьИзмененными() при модификации данных.

7. Обработка ошибок при добавлении строк

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

1. Ошибка типа данных

Если пытаетесь записать строку в числовую колонку:

Попытка
НоваяСтрока.Цена = "Двадцать рублей"; // Ошибка!
Исключение
Сообщить("Некорректный формат данных: " + ОписаниеОшибки());
КонецПопытки;

2. Нарушение уникальности

Попытка
Таблица.Индексы.ПоКоду.УстановитьТипИндекса(ТипИндексаТаблицыЗначений.Уникальный);
ДобавитьДубликат(Таблица, "Код1"); // Вызовет ошибку
Исключение
Если ТипОшибки(ИнформацияОбОшибке()) = Тип("ОшибкаИндексацииТаблицыЗначений") Тогда
Сообщить("Дублирующееся значение ключа!");
КонецЕсли;
КонецПопытки;

3. Переполнение таблицы

В старых версиях платформы (до 8.3.10) существовал лимит в 2 147 483 647 строк. В современных версиях лимит выше, но всё равно стоит контролировать размер:

Если Таблица.Количество() > 1000000 Тогда
Предупреждение("Превышен рекомендуемый размер таблицы!");
КонецЕсли;

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

8. Продвинутые техники: динамическое добавление колонок и строк

Иногда структура таблицы значений заранее неизвестна. В таких случаях можно динамически добавлять колонки и строки:

Динамическое создание колонок

ИменаКолонок = Новый Массив;
ИменаКолонок.Добавить("Наименование");
ИменаКолонок.Добавить("Цена");
ИменаКолонок.Добавить("ДатаПоступления");

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

Добавление строк из JSON

JSONСтрока = '{"Товары": [{"Название": "Монитор", "Цена": 15000}, {"Название": "Клавиатура", "Цена": 1200}]}';
Данные = JSON.Прочитать(JSONСтрока);

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

Для Каждого Товар Из Данные.Товары Цикл
Строка = Таблица.Добавить();
Строка.Название = Товар.Название;
Строка.Цена = Товар.Цена;
КонецЦикла;

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

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

FAQ: Частые вопросы по работе с таблицами значений

&НаКлиенте
Процедура ДобавитьСтроку(Команда)
НоваяСтрока = ЭлементыФормы.Товары.Добавить();
НоваяСтрока.Наименование = "Новый товар";
НоваяСтрока.Количество = 1;
КонецПроцедуры

&НаКлиенте
Процедура ПослеИзмененияНаСервере()
ЭлементыФормы.Товары.Обновить();
КонецПроцедуры

Источник = Таблица[0]; // Первая строка
НоваяСтрока = Таблица.Добавить();
НоваяСтрока.Копировать(Источник);

НоваяТаблица.Добавить().Копировать(ИсточникТаблица[Индекс]);

НоваяСтрока = Таблица.Добавить();
Если УсловиеНеВыполнено Тогда
Таблица.Удалить(Таблица.Количество()-1); // Удаляем последнюю строку
КонецЕсли;

ЭлементыФормы.Таблица.АвтоОбновление = Ложь;
// Добавляем строки...
ЭлементыФормы.Таблица.АвтоОбновление = Истина;
ЭлементыФормы.Таблица.Обновить();