Где писать запрос в 1С: все рабочие места разработчика

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

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

Консоль запросов в режиме «Предприятие» — главный инструмент отладки

Консоль запросов — это внешняя обработка (файл .epf), которая открывается в режиме «Предприятие» и позволяет написать запрос, сразу выполнить его и увидеть результат в виде таблицы. Это самый быстрый способ проверить, какие данные вернёт выборка, не изменяя конфигурацию.

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

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

1. 1
   Получите файл консоли запросов (.epf) с диска ИТС или из внутренних ресурсов компании
2. 2
   Откройте базу в режиме «Предприятие» под пользователем с достаточными правами
3. 3
   Через «Файл» → «Открыть» загрузите обработку консоли
4. 4
   Вставьте или напишите текст запроса, заполните параметры
5. 5
   Нажмите «Выполнить» и проверьте таблицу результата

Конструктор запроса в конфигураторе

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

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

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

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

В реальных доработках запрос живёт внутри модуля — объекта, формы, общего модуля или менеджера объекта. Там создаётся объект «Запрос», ему присваивается текст, устанавливаются параметры, и результат обходится в цикле или выгружается в таблицу значений. Типовой шаблон выглядит следующим образом.

Запрос = Новый Запрос;
Запрос.Текст =
"ВЫБРАТЬ
| Товары.Ссылка КАК Номенклатура,
| Товары.Цена КАК Цена
|ИЗ
| Справочник.Номенклатура КАК Товары
|ГДЕ
| Товары.Цена > &МинЦена";
Запрос.УстановитьПараметр("МинЦена", 1000);
Результат = Запрос.Выполнить();
Выборка = Результат.Выбрать();
Пока Выборка.Следующий() Цикл
 Сообщить(Выборка.Номенклатура);
КонецЦикла;

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

Для отладки запроса из модуля удобно скопировать его текст в консоль запросов: в конфигураторе есть команда «Конструктор запроса», а текст с параметрами проще перенести в консоль и выполнить там с теми же значениями параметров.

Запрос в схеме компоновки данных (СКД) для отчётов

Если запрос нужен для отчёта, его пишут не в модуле, а в схеме компоновки данных. В конфигураторе откройте отчёт, перейдите к основной схеме компоновки данных, на закладке «Наборы данных» добавьте набор типа «Запрос» — откроется поле для текста. Здесь работает тот же конструктор запроса, вызываемый кнопкой.

Особенность СКД: не нужно писать в запросе всё, что умеет сама компоновка. Группировки, итоги, отборы и сортировку лучше оставить настройкам отчёта, а в запросе выбрать «сырые» данные с нужными полями. Параметры в СКД объявляются на закладке «Параметры», а виртуальные таблицы регистров принимают параметры периода прямо в тексте.

Динамические списки и другие места, где встречается текст запроса

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

Ещё запросы пишут в текстах обработчиков событий, регламентных заданий, при программной работе с СКД и в расширениях конфигурации. Везде действует одно правило: текст запроса — это строка на языке запросов, и проверить её проще всего в консоли до вставки в код.

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

Самая частая ошибка — неверное имя таблицы или поля. Язык запросов оперирует метаданными: если справочник называется «Номенклатура», то писать «Справочник.Товары» нельзя, даже если так привычнее. Вторая типичная проблема — забытые параметры: запрос с &Параметром, для которого не вызван УстановитьПараметр, выдаст ошибку при выполнении.

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

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