Как добавить строку в запросе 1С

Фраза «добавить строку в запросе 1С» на практике означает три разные задачи. Первая — дополнить результат запроса дополнительными строками через конструкцию ОБЪЕДИНИТЬ ВСЕ. Вторая — программно добавить строку в таблицу значений, полученную из запроса. Третья — добавить строку в табличную часть документа или справочника кодом. Каждая задача решается своим инструментом, и путать их нельзя: синтаксис запроса работает на уровне СУБД, а методы Добавить() — на уровне встроенного языка платформы.

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

Определите, где именно нужно добавить строку

Прежде чем писать код, ответьте на вопрос: строка должна появиться в результате запроса, в таблице значений в памяти или в табличной части объекта базы данных? От этого зависит инструмент. Запрос в 1С — это только чтение данных: он не может вставить строку в таблицу базы, как INSERT в классическом SQL. Поэтому «добавить строку запросом» в буквальном смысле невозможно — можно лишь скомпоновать строки в выборке.

Если цель — изменить данные в базе (например, добавить товар в документ), работа ведётся не через запрос, а через объектную модель: получение объекта, добавление строки в табличную часть, запись. Если цель — вывести в отчёт дополнительную строку, которой нет в базе (итог, пустая строка, строка-заглушка), используется ОБЪЕДИНИТЬ ВСЕ или добавление строки в таблицу значений после выполнения запроса.

Добавление строки в тексте запроса через ОБЪЕДИНИТЬ ВСЕ

Конструкция ОБЪЕДИНИТЬ ВСЕ склеивает строки нескольких выборок в одну. Это основной способ «добавить строку» непосредственно в запросе. Вторая часть объединения может выбирать данные не из таблицы, а из литералов — тогда в результате появится строка с заданными значениями.

ВЫБРАТЬ
Товары.Номенклатура КАК Номенклатура,
Товары.Количество КАК Количество
ИЗ
Документ.РеализацияТоваровУслуг.Товары КАК Товары
ГДЕ
Товары.Ссылка = &Ссылка

ОБЪЕДИНИТЬ ВСЕ

ВЫБРАТЬ
ЗНАЧЕНИЕ(Справочник.Номенклатура.ПустаяСсылка),
0

Важное правило: количество, порядок и типы полей во всех частях объединения должны совпадать. Если в первой выборке поле имеет тип «СправочникСсылка.Номенклатура», то и во второй части нужно передать значение того же типа — например, через ЗНАЧЕНИЕ() с пустой ссылкой. Несовпадение типов — самая частая причина ошибки «Несовместимые типы в объединении».

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

Добавление строки в таблицу значений после выполнения запроса

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

РезультатЗапроса = Запрос.Выполнить();
ТаблицаРезультата = РезультатЗапроса.Выгрузить();

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

Обращайте внимание на типы колонок. Таблица значений, полученная из запроса, наследует типы полей выборки. Если колонка «Количество» имеет тип Число с длиной 15 и точностью 3, попытка записать туда строку вызовет ошибку преобразования. Перед добавлением проверьте состав колонок через ТаблицаРезультата.Колонки, особенно если таблица формируется в разных ветках алгоритма.

Этот способ удобен для промежуточных вычислений: добавления итоговых строк, строк-разделителей, служебных записей перед выводом в табличный документ или передачей в СКД. Таблица значений живёт только в памяти сеанса — при завершении процедуры данные теряются.

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

Добавление строки в табличную часть документа программно

Если под «добавить строку» понимается добавление позиции в документ, запрос здесь не нужен вовсе. Работа идёт через объектную модель: получить объект документа, добавить строку в табличную часть, заполнить поля, записать.

ДокументОбъект = ДокументСсылка.ПолучитьОбъект();
НоваяСтрока = ДокументОбъект.Товары.Добавить();
НоваяСтрока.Номенклатура = ВыбраннаяНоменклатура;
НоваяСтрока.Количество = 5;
НоваяСтрока.Цена = 1200;
НоваяСтрока.Сумма = НоваяСтрока.Количество * НоваяСтрока.Цена;
ДокументОбъект.Записать(РежимЗаписиДокумента.Проведение);

Ключевые моменты: ПолучитьОбъект() загружает документ целиком, поэтому для массовой обработки такой код выполняется медленно — на больших объёмах групповое изменение лучше делать в транзакции с контролем ошибок. Метод Записать() с проведением пересчитает движения документа; если проведение не нужно, используйте РежимЗаписиДокумента.Запись.

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

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

Частый бытовой сценарий: разработчик работает в консоли запросов и хочет добавить строку в параметр-список или во временную таблицу. Для параметра типа «Список значений» в консоли запросов строка добавляется кнопкой добавления в редакторе параметра — это интерфейсное действие, а не код. В самом тексте запроса список значений формируется через конструкцию В (&Список), а наполняется список уже в коде методом Добавить().

Если нужно собрать временную таблицу из фиксированных строк прямо в запросе, используется приём с ОБЪЕДИНИТЬ ВСЕ и помещением результата во временную таблицу:

ВЫБРАТЬ
1 КАК НомерСтроки,
"Первая строка" КАК Описание
ПОМЕСТИТЬ ВТ_Данные

ОБЪЕДИНИТЬ ВСЕ

ВЫБРАТЬ
2,
"Вторая строка"

Такой приём удобен для тестирования запросов без реальных данных и для передачи в запрос небольших фиксированных наборов. При большом количестве строк эффективнее передать таблицу значений через параметр и поместить её во временную таблицу конструкцией ВЫБРАТЬ ... ИЗ &Таблица.

1. 1
   Определите, где должна появиться строка: в выборке, таблице значений или табличной части объекта
2. 2
   Для выборки добавьте ОБЪЕДИНИТЬ ВСЕ с совпадающими по типам полями
3. 3
   Для таблицы значений вызовите Добавить() и заполните поля новой строки
4. 4
   Для документа получите объект, добавьте строку в табличную часть и запишите
5. 5
   Проверьте результат: количество строк, типы полей, движения документа

Проверка результата и типичные ошибки

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

Ограничения и альтернативные подходы

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

Для пакетного добавления большого числа строк в таблицу значений перед выводом в отчёт рассмотрите альтернативу: сформировать все данные одним запросом с объединениями, а не добавлять строки по одной в цикле. Один запрос с ОБЪЕДИНИТЬ ВСЕ обычно работает быстрее, чем многократные обращения к базе внутри цикла.

Частые вопросы