Как создать строку в табличной части 1С: 5 рабочих способов с примерами

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

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

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

1. Что такое табличная часть в 1С и зачем она нужна

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

Ключевые особенности табличных частей:

• 📌 Иерархическая структура: каждая строка может содержать вложенные табличные части (например, спецификация номенклатуры).
• 🔄 Динамическое изменение: строки можно добавлять, редактировать и удалять как программно, так и через интерфейс.
• 🔒 Связь с владельцем: табличная часть не существует отдельно от объекта (например, документа), к которому она привязана.
• 📊 Типизированные колонки: каждая колонка имеет определённый тип данных (число, строка, справочник и т.д.), что обеспечивает контроль целостности.

В последних версиях платформы (1С:Предприятие 8.3.20+) появились новые возможности работы с табличными частями, такие как:

• 🖥️ Динамические списки для отображения больших объёмов данных без подгрузки всех строк.
• 🔄 Автоматическое сохранение изменений при редактировании в управляемых формах.
• 📎 Привязка к реквизитам для упрощения доступа к данным из кода.

⚠️ Внимание: В конфигурациях на базе БСП (Библиотека стандартных подсистем) логика работы с табличными частями может отличаться из-за переопределённых обработчиков событий. Всегда проверяйте наличие кастомных процедур в модуле объекта.

2. Способ 1: Добавление строки через интерфейс пользователя

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

Пошаговая инструкция:

1. Откройте документ или справочник, содержащий табличную часть (например, документ «Поступление товаров»).
2. Перейдите на вкладку с нужной табличной частью (например, «Товары»).
3. Нажмите кнопку Добавить (или комбинацию клавиш Insert/Ctrl+N, в зависимости от настройки интерфейса).
4. Заполните поля новой строки (номенклатура, количество, цена и т.д.).
5. Сохраните документ (Ctrl+S или кнопка «Записать»).

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

• ✅ Быстрота: не требует написания кода.
• ❌ Ограничения: невозможно автоматизировать или добавить несколько строк одновременно.
• 🔄 Зависимость от прав: пользователь должен иметь права на редактирование документа.

В управляемых формах (начиная с версии 8.2) добавление строки может сопровождаться автоматическим заполнением некоторых полей (например, подстановкой текущей даты или значения по умолчанию). Это задаётся в конфигураторе в свойствах табличной части на закладке «Данные».

3. Способ 2: Программное добавление строки (встроенный язык)

Для автоматизации или массового добавления строк используется встроенный язык 1С. Основной метод — работа с коллекцией ТабличнаяЧасть через свойство объекта.

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

// Получаем документ
Док = Документы.ПоступлениеТоваров.СоздатьДокумент();
// Получаем табличную часть "Товары"
ТабличнаяЧасть = Док.Товары;

// Добавляем новую строку
НоваяСтрока = ТабличнаяЧасть.Добавить();
// Заполняем реквизиты строки
НоваяСтрока.Номенклатура = Справочники.Номенклатура.НайтиПоНаименованию("Стул офисный");
НоваяСтрока.Количество = 5;
НоваяСтрока.Цена = 1500;
НоваяСтрока.Сумма = НоваяСтрока.Количество * НоваяСтрока.Цена;

// Сохраняем документ
Док.Записать();

Ключевые моменты:

• 🔹 Метод Добавить() возвращает новую строку, которую можно сразу заполнять.
• 🔹 Для справочников используйте методы НайтиПоНаименованию() или НайтиПоКоду().
• 🔹 После добавления строки обязательно вызовите метод Записать() у документа, иначе изменения не сохранятся в базе.

Если нужно добавить несколько строк, используйте цикл:

Для Сч = 1 По 10 Цикл
НоваяСтрока = ТабличнаяЧасть.Добавить();
НоваяСтрока.Номенклатура = МассивНоменклатуры[Сч];
НоваяСтрока.Количество = 1;
КонецЦикла;

⚠️ Внимание: При работе с управляемыми формами после программного добавления строки может потребоваться вызвать ОбновитьФорму(), чтобы изменения отобразились на экране.

4. Способ 3: Копирование строк из другой табличной части

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

Пример кода:

// Источник - документ реализации
Источник = Документы.РеализацияТоваров.НайтиПоНомеру("РТ-000123");
// Приёмник - новый документ возврата
Приемник = Документы.ВозвратТоваровОтПокупателя.СоздатьДокумент();

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

Нюансы копирования:

• 🔄 Ссылочные типы: При копировании ссылок (номенклатура, контрагенты) проверяйте, что объекты существуют в базе.
• 📝 Реквизиты по умолчанию: Некоторые поля (например, «Склад») могут требовать ручного заполнения.
• 🔒 Блокировки: Если источник заблокирован, копирование может завершиться ошибкой.

Для оптимизации производительности при копировании большого количества строк (1000+) рекомендуется:

1. Отключить автоматический расчёт итогов (ТабличнаяЧасть.ОтключитьИтоги()).
2. Использовать пакетную запись (НачатьТранзакцию()/ЗафиксироватьТранзакцию()).
3. Применять ЗаполнитьЗначенияСвойств() для массового заполнения реквизитов.

5. Способ 4: Добавление строк с использованием запросов

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

Пример: добавление строк в документ «Поступление товаров» из временной таблицы:

Запрос = Новый Запрос;
Запрос.Текст =
"ВЫБРАТЬ
|   Товары.Номенклатура КАК Номенклатура,
|   Товары.Количество КАК Количество
|ИЗ
|   ВременноеХранилище.Товары КАК Товары";

// Выполняем запрос
Результат = Запрос.Выполнить();
Док = Документы.ПоступлениеТоваров.СоздатьДокумент();

// Добавляем строки из результата
Выборка = Результат.Выбрать();
Пока Выборка.Следующий() Цикл
НоваяСтрока = Док.Товары.Добавить();
НоваяСтрока.Номенклатура = Выборка.Номенклатура;
НоваяСтрока.Количество = Выборка.Количество;
КонецЦикла;

Преимущества метода:

• 🔍 Гибкость: можно отфильтровать или преобразовать данные перед добавлением.
• 📊 Производительность: запросы оптимизированы для работы с большими объёмами данных.
• 🔗 Интеграция: удобно использовать при обмене данными с другими системами.

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

Для ускорения массового добавления через запросы применяйте конструкцию ОБЪЕДИНИТЬ ВСЕ:

Запрос.Текст =
"ВЫБРАТЬ
|   Товар КАК Номенклатура,
|   1 КАК Количество
|ИЗ
|   Справочник.Номенклатура КАК Товар
|ГДЕ
|   Товар.ЭтоГруппа = ЛОЖЬ
|
|ОБЪЕДИНИТЬ ВСЕ
|
|ВЫБРАТЬ
|   Услуга КАК Номенклатура,
|   1 КАК Количество
|ИЗ
|   Справочник.Номенклатура КАК Услуга
|ГДЕ
|   Услуга.ВидНоменклатуры = &ВидУслуга";

6. Способ 5: Работа с табличными частями в управляемых формах

В управляемых формах (начиная с версии 8.2) добавление строк имеет особенности из-за клиент-серверной архитектуры. Здесь используется объект ЭлементыФормы.

Пример кода для формы документа:

// Получаем табличную часть на форме
ТаблицаТоваров = ЭлементыФормы.Товары;

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

Ключевые отличия от обычного режима:

• 🖥️ Клиент-серверное взаимодействие: часть кода выполняется на клиенте, часть — на сервере.
• 🔄 Автоматическое обновление: после добавления строка сразу отображается в форме.
• 📎 Привязка к данным: изменения в таблице на форме автоматически синхронизируются с объектом документа.

Для добавления строки с сервера (например, в обработчике события) используйте:

&НаСервере
Процедура ДобавитьСтрокуНаСервере()
Док = Документы.ПоступлениеТоваров.ТекущийДокумент();
НоваяСтрока = Док.Товары.Добавить();
НоваяСтрока.Номенклатура = Справочники.Номенклатура.НайтиПоНаименованию("Монитор 24\"");
КонецПроцедуры

В БСП (Библиотека стандартных подсистем) для добавления строк часто используют процедуру ДобавитьСтроку() из модуля формы. Например:

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

7. Типичные ошибки и как их избежать

При работе с табличными частями разработчики часто сталкиваются с одними и теми же проблемами. Вот наиболее распространённые ошибки и способы их решения:

Ещё одна распространённая проблема — потеря данных при редактировании. Это происходит, если:

• 🔹 Не используется ПометитьНаУдаление() перед изменением существующей строки.
• 🔹 В транзакции происходит откат (ОтменитьТранзакцию()).
• 🔹 Нарушена логика блокировок (например, другой пользователь изменил документ параллельно).

Для отладки используйте конструкцию Попытка...Исключение:

Попытка
Док.Записать();
Исключение
Сообщить("Ошибка при записи: " + ОписаниеОшибки());
Возврат Ложь;
КонецПопытки;

8. Оптимизация производительности при массовом добавлении

При добавлении большого количества строк (1000+) стандартные методы могут работать медленно. Для ускорения используйте следующие техники:

1. Отключение итогов и контроля:

ТабличнаяЧасть.ОтключитьИтоги();
ТабличнаяЧасть.ОтключитьКонтроль();

2. Пакетная запись:

НачатьТранзакцию();
Для Сч = 1 По 1000 Цикл
ТабличнаяЧасть.Добавить();
КонецЦикла;
ЗафиксироватьТранзакцию();

3. Массовое заполнение через ЗаполнитьЗначенияСвойств():

МассивДанных = Новый Массив();
МассивДанных.Добавить(Новый Структура("Номенклатура,Количество", Номенклатура1, 10));
МассивДанных.Добавить(Новый Структура("Номенклатура,Количество", Номенклатура2, 5));

ТабличнаяЧасть.ЗаполнитьЗначенияСвойств(МассивДанных);

4. Использование временных таблиц:

Для загрузки данных из внешних источников (Excel, JSON) сначала сохраните их во временную таблицу, а затем добавьте в документ пакетом.

Сравнение методов по производительности (тест на 10 000 строк):

Для распределённых баз данных (РИБ) учитывайте:

• 🔄 Синхронизация больших табличных частей может занимать много времени.
• 📡 Используйте ПланОбмена.ОтправитьИзменения() только после завершения всех операций.
• 🔒 Блокируйте документ на время изменения (Док.Заблокировать()).

FAQ: Ответы на частые вопросы

ТабличнаяЧасть.Вставить(0); // Добавит строку в начало
ТабличнаяЧасть.Вставить(ТабличнаяЧасть.Количество()); // Добавит в конец

ТабличнаяЧасть.Сортировать("Номенклатура Возр");

Док.Товары.Добавить(); // Строка добавлена, но не сохранена
Док.Записать(); // Теперь строка сохранена в базе

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

НоваяСтрока = Приемник.Товары.Добавить();
Копировать(Строка, НоваяСтрока);

НоваяСтрока.Номенклатура = "Стул"; // Ошибка! Ожидается ссылка на справочник
НоваяСтрока.Номенклатура = Справочники.Номенклатура.НайтиПоНаименованию("Стул"); // Правильно

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

// Вызов из обработки
Док = Документы.ПоступлениеТоваров.ТекущийДокумент();
ДобавитьСтрокуНаСервере(Док);