Другое · 8 мин
Как добавить запрос в форму 1С и вывести результат
Как добавить запрос в форму 1С: порядок создания запроса, передача параметров, вывод результата в табличную часть или список, проверка и типичные ошибки при самостоятельной настройке.
Запрос в форме 1С используется, когда стандартного списка или отбора недостаточно: нужно отобрать данные по сложному условию, объединить несколько таблиц, вычислить промежуточные значения или показать выборку из регистров накопления и сведений. Результат обычно выводится в поле формы, табличную часть или список значений, откуда пользователь может выбрать строку или увидеть сводку.
Добавление запроса состоит из трех этапов: составить текст запроса на языке запросов, выполнить его и присвоить полученную таблицу значений соответствующему элементу формы. В управляемых формах выполнение лучше размещать на сервере, а в клиенте только отображать готовый результат, чтобы не замедлять интерфейс.
Неправильно составленный запрос может привести к долгой работе формы, блокировкам или ошибкам доступа, поэтому перед внесением изменений рекомендуется сохранить копию конфигурации, проверить права и протестировать на выделенной базе. Изменения в типовой конфигурации лучше вносить через расширение или копию объекта, а не напрямую.
Когда запрос на форме нужен и что он дает
Запрос оправдан, если форма должна показывать данные, недоступные через обычную выборку: например, остатки по нескольким складам одновременно, документы с фильтром по реквизиту табличной части или расчетный остаток на дату. Стандартные формы подходят для простых списков, а запрос добавляет гибкости при сложной логике отбора.
Результат запроса не хранится в самой форме автоматически: его нужно явно получить в переменную типа ТаблицаЗначений и привязать к элементу управления. Если форма переоткрывается, запрос обычно выполняется повторно, поэтому важно учитывать производительность и объем возвращаемых данных.
Способы добавления запроса в форму
Управляемая форма: серверное выполнение
В управляемом приложении запрос создается в модуле формы, чаще всего в процедуре с директивой &НаСервере. Текст запроса пишется на языке запросов 1С, параметры передаются через метод УстановитьПараметр, после чего вызывается Выполнить и результат выгружается методом Выгрузить. Это снижает нагрузку на клиент и соответствует архитектуре управляемых форм.
Полученную таблицу значений можно присвоить значению элемента формы, загрузить в табличную часть или использовать для заполнения списка выбора. Если данные нужно редактировать, более удобно выгружать результат в табличную часть формы, а не просто выводить в поле.
Обычное приложение: клиентское и серверное выполнение
В обычном приложении запрос может выполняться и на клиенте, но для больших объемов данных предпочтительнее серверный вариант. Разница заключается в месте выполнения и способе доступа к данным, а порядок работы с объектом Запрос остается схожим: создать, задать текст, установить параметры, выполнить, выгрузить.
При переносе формы между вариантами приложения нужно проверять, где именно находится код выполнения запроса, иначе форма может работать некорректно после переноса или обновления платформы.
Пошаговое создание запроса и вывод результата
Откройте модуль формы и добавьте процедуру, которая будет заполнять нужный элемент. В ней создайте объект Запрос, укажите текст запроса с источниками данных, условиями отбора и полями для вывода. Используйте параметры для дат, номеров документов и ссылок, чтобы избежать ошибок форматирования и упростить поддержку.
После выполнения запроса получите таблицу значений. Если целевой элемент — табличная часть, очистите существующие строки и добавьте новые из результата запроса в цикле. Если элемент — поле ввода или список, присвойте ему соответствующее значение или загрузите в список значения.
Затем вызовите эту процедуру при открытии формы, изменении реквизита или нажатии кнопки, в зависимости от сценария. Проверьте, что форма обновляется корректно, данные соответствуют ожидаемому отбору, а лишние строки не дублируются.
- 1Создать процедуру заполнения в модуле формы
- 2Объявить объект Запрос и задать текст запроса
- 3Установить параметры запроса
- 4Выполнить запрос и выгрузить таблицу значений
- 5Заполнить табличную часть или присвоить значение элементу формы
- 6Проверить результат на тестовой базе
Параметры, условия и безопасность
Все внешние значения, вводимые пользователем или полученные из реквизитов формы, лучше передавать через параметры запроса. Это защищает от ошибок при работе с датами и строками, упрощает чтение кода и снижает риск некорректной интерпретации текста запроса.
Условия отбора должны соответствовать правам пользователя. Если запрос обращается к регистрам или справочникам, недоступным для роли, форма может выдать ошибку или вернуть пустой результат. Проверяйте права доступа отдельно, не полагаясь только на настройки формы.
Изменение типовой конфигурации напрямую может создать сложности при обновлении. Безопаснее работать с копией объекта или расширением конфигурации, а перед внедрением сделать резервную копию информационной базы и проверить форму на изолированной среде.
Проверка результата и ограничения
Проверьте, что запрос возвращает ожидаемые строки, а не пустую таблицу из-за неверного отбора или пустого параметра. Сравните результат с данными в справочниках и регистрах вручную для нескольких типичных случаев. Обратите внимание на производительность: если форма открывается заметно дольше, возможно, запрос читает слишком много данных или не использует подходящие индексы.
Ограничение по объему результата помогает избежать зависания формы. Если выборка большая, добавьте ограничение по дате, организации или другому отбору, а также рассмотрите постраничный вывод вместо загрузки всех записей сразу.
Как проверить результат
Данные соответствуют отбору и справочникам
Пустая таблица или лишние строки
Приемлемая скорость
Заметные задержки или зависание
Ошибок доступа нет
Ошибка при чтении регистров или справочников
Признак корректной работы: форма открывается без ошибок, таблица заполняется актуальными данными, выбор строки или сохранение формы не вызывают исключений. Признак проблемы: пустой результат при ожидаемых данных, долгая загрузка, ошибка доступа или несоответствие сумм и остатков.
Альтернативы и когда не стоит использовать запрос
Если достаточно стандартного отбора по реквизитам или встроенного списка выбора, добавлять запрос не нужно: это усложнит поддержку и может замедлить форму. Для простых фильтров лучше использовать свойства элементов формы или стандартные механизмы отбора.
Когда нужны расчеты на основе данных из нескольких регистров, запрос уместен, но для сложных отчетов может быть целесообразнее отдельный отчет или обработка с настройкой вывода. Запрос на форме подходит для оперативного выбора и просмотра, а не для массовой обработки тысяч строк.
Если форма используется многими пользователями одновременно, тяжелые запросы могут создать нагрузку на сервер базы данных. В таких случаях стоит ограничить выборку, кэшировать результат там где это допустимо, или перенести вычисления в фоновое задание.
Что важно запомнить
Запрос создается в модуле формы, выполняется с параметрами, результат загружается в таблицу значений и выводится в элемент формы. Тестируйте на копии базы и учитывайте права и производительность.
Нужно ли всегда выполнять запрос на сервере?
Не всегда, но для управляемых форм и больших объемов данных серверное выполнение предпочтительнее. Клиентское выполнение допустимо для небольших выборок, когда важна скорость разработки и нагрузка на сервер невелика.
Можно ли выгрузить результат запроса напрямую в табличную часть?
Прямое присваивание таблицы значений в табличную часть формы зависит от типа элемента и контекста. Чаще результат предварительно выгружается в ТаблицаЗначений, затем строки копируются в табличную часть формы в цикле с очисткой старых данных.
Что делать, если запрос возвращает ошибку доступа?
Проверьте права текущего пользователя на таблицы и регистры, задействованные в запросе. Ошибка может возникать не из-за текста запроса, а из-за отсутствия ролей или ограничений доступа к данным в информационной базе.
Безопасно ли править типовую конфигурацию для добавления запроса?
Прямые правки типовой конфигурации небезопасны при обновлениях: изменения могут затереться или вызвать конфликты. Предпочитайте копию объекта или расширение конфигурации, а перед работой делайте резервную копию базы.