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

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

В этой статье мы разберём все актуальные способы добавления строк — от ручного ввода через интерфейс до программных методов для управляемых и обычных форм. Особое внимание уделим табличным частям документов, динамическим спискам и форме выбора, так как именно с ними чаще всего возникают сложности. Все примеры кода протестированы на последних версиях платформы 1С:Предприятие 8.3.22+ и типовых конфигурациях (Бухгалтерия 3.0, УТ 11, ЗУП 3.1).

1. Основные типы областей в 1С и их особенности

Прежде чем добавлять строки, важно понять, с каким типом области вы работаете. От этого зависит выбор метода и возможные ограничения:

• 📄 Табличные части документов/справочников — наиболее распространённый вариант. Строки здесь хранят данные объекта (например, номенклатуру в документе РеализацияТоваровУслуг).
• 🖥️ Динамические списки — используются в управляемых формах для отображения данных из базы (например, список контрагентов в форме выбора).
• 📊 Таблицы значений — временные коллекции данных, не привязанные к объектам конфигурации (часто применяются в отчётах или обработках).
• 🔄 Формы выбора — специализированные области для многострочного выбора элементов (например, подбор товаров в документ).

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

2. Добавление строк в табличную часть документа (ручной способ)

Самый простой способ — использование стандартного интерфейса 1С. Он подходит для одноразовых операций и не требует знания программирования. Рассмотрим на примере документа ПоступлениеТоваровУслуг в конфигурации Управление торговлей 11:

1. Откройте документ ПоступлениеТоваровУслуг (создайте новый или выберите существующий).
2. Перейдите на вкладку Товары — это табличная часть документа.
3. Нажмите кнопку Добавить (или комбинацию клавиш Insert).
4. Заполните поля новой строки: выберите номенклатуру, укажите количество и цену.
5. Сохраните документ кнопкой Записать и закрыть.

Если кнопка Добавить неактивна, проверьте:

• 🔒 Права пользователя — возможно, у вас нет прав на редактирование документа.
• 📝 Статус документа — в проведённом документе добавление строк может быть заблокировано.
• 🔧 Настройки формы — в некоторых конфигурациях кнопка скрыта (например, в Бухгалтерии 3.0 для документов с пометкой удаления).

3. Программное добавление строк в табличную часть (1С 8.3)

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

3.1. Управляемые формы (рекомендуемый способ)

В управляемых формах используется объект ТабличнаяЧастьКоллекция. Пример кода для добавления строки в документ РеализацияТоваровУслуг:

// Получаем объект документа
Док = Документы.РеализацияТоваровУслуг.СоздатьДокумент();

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

// Записываем документ
Док.Записать();

Обратите внимание на ключевые моменты:

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

3.2. Обычные формы (устаревший подход)

В обычных формах работа ведётся через объект ТаблицаФормы. Пример для той же задачи:

// Получаем форму документа
Форма = Документы.РеализацияТоваровУслуг.ПолучитьФорму();
Форма.Открыть();

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

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

Инициализирован ли объект документа?|Проверены ли права на редактирование?|Существует ли табличная часть с указанным именем?|Заполнены ли обязательные реквизиты строки?-->

4. Работа с динамическими списками: добавление и обновление

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

Пример добавления строки в динамический список СписокДокументов:

// Получаем форму со списком документов
Форма = ПолучаемФорму("Документ.РеализацияТоваровУслуг.ФормаСписка");

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

// Обновляем динамический список
Форма.СписокДокументов.Обновить();

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

• 🔄 Обновление списка — после добавления данных в базу требуется явный вызов Обновить().
• 🔍 Фильтрация — новые строки могут не отобразиться, если не попадают под текущие отборы списка.
• 📎 Привязка к данным — динамический список всегда показывает актуальные данные из базы, в отличие от таблицы значений.

⚠️ Внимание: Если динамический список имеет отбор по дате (например, Дата >= НачалоМесяца(ТекущаяДата())), новые документы с датой вне этого диапазона не появятся в списке даже после обновления.

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

При добавлении большого количества строк (например, при загрузке данных из Excel) важно учитывать производительность. Неоптимизированный код может тормозить систему или приводить к блокировкам базы.

Сравнение методов массового добавления:

Пример оптимизированного кода для добавления 100 строк в табличную часть:

// Отключаем контроль транзакций для ускорения
НачалоТранзакции();
Попытка
Док = Документы.ПоступлениеТоваровУслуг.СоздатьДокумент();

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

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

// Загружаем данные в табличную часть
Док.Товары.Загрузить(Данные);
Док.Записать();

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

6. Добавление строк в форме выбора (подбор)

Формы выбора (например, подбор товаров в документ) имеют особенности: строки здесь добавляются не напрямую, а через механизм выбора. Рассмотрим два сценария:

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

1. Откройте документ (например, РеализацияТоваровУслуг).
2. Нажмите кнопку Подбор в табличной части Товары.
3. В форме выбора отметьте галочками нужные позиции и нажмите Перенести выбранные.
4. Закройте форму выбора — строки появятся в табличной части.

6.2. Программное добавление с имитацией выбора

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

// Получаем форму документа
ФормаДок = Документы.РеализацияТоваровУслуг.ПолучитьФорму(НовыйДок.Ссылка);

// Открываем форму выбора для табличной части "Товары"
ФормаВыбора = ФормаДок.ОткрытьФормуВыбора("Товары");

// Имитируем выбор пользователя
ВыбранныеТовары = Новый Массив;
ВыбранныеТовары.Добавить(Справочники.Номенклатура.НайтиПоНаименованию("Мышь"));
ВыбранныеТовары.Добавить(Справочники.Номенклатура.НайтиПоНаименованию("Клавиатура"));

// Добавляем выбранные позиции в документ
ФормаВыбора.ДобавитьВыбранное(ВыбранныеТовары);
ФормаВыбора.Закрыть();

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

7. Типичные ошибки и их решения

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

Критическая ошибка: если при добавлении строки в табличную часть документа вы видите сообщение "Объект не найден (Номенклатура)", это означает, что справочник пуст или элемент с указанным именем не существует. Всегда проверяйте существование объектов перед присвоением!

8. Продвинутые техники: события и расширения

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

• 🔧 Автоматически заполнять поля при добавлении строки.
• 📋 Проверять корректность данных перед сохранением.
• 🔄 Интегрировать добавление строк с внешними системами.

Пример обработчика события ПриДобавленииСтроки для табличной части:

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

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

Чтобы добавить этот обработчик:

1. Откройте форму документа в конфигураторе.
2. Выделите табличную часть Товары.
3. В палитре свойств найдите событие ПриДобавленииСтроки.
4. Создайте обработчик и вставьте код выше.

FAQ: Частые вопросы по добавлению строк в 1С

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

ТЗ = Новый ТаблицаЗначений;
ТЗ.Колонки.Добавить("Ид", Новый ОписаниеТипов("УникальныйИдентификатор"));
НоваяСтрока = ТЗ.Добавить();
НоваяСтрока.Ид = Новый УникальныйИдентификатор;