К статье
Практический материал

Другое · 9 мин

Как сделать форму запроса в 1С: пошаговая инструкция

Как создать форму запроса в 1С: пошаговое руководство по запросу, параметрам, открытию и проверке результата в управляемых формах.

Форма запроса в 1С — это форма, построенная на тексте запроса и предназначенная для быстрого просмотра отобранных данных без разработки полноценного отчёта. Она выводит результат запроса в виде таблицы, позволяет задавать параметры фильтрации и открываться как обычное окно приложения. Такой подход удобен для разовых аналитических задач, проверки остатков, сверки движения по регистрам и поиска документов по условиям.

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

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

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

Когда форма запроса подходит, а когда лучше другой инструмент

Форма запроса оправдана, если нужно быстро получить таблицу данных по сложному условию, объединяющему несколько регистров или документов, и нет времени на разработку отдельного отчёта. Она удобна для ад-hoc-анализа, проверки правильности заполнения и поиска по реквизитам, которые не выводятся в обычных формах.

Если пользователям требуется регулярно работать с одними и теми же данными, сохранять настройки, формировать печатные формы или редактировать записи, лучше использовать отчёт, обработку с табличной частью или обычную форму объекта. Форма запроса обычно не заменяет полноценный учётный документ и не подходит для массового ввода данных.

Признаки, что форма запроса является удачным выбором

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

Когда стоит выбрать альтернативу

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

Создание запроса в консоли запросов

Перед созданием формы составьте и отладьте текст запроса в консоли запросов. Укажите нужные таблицы, поля, условия отбора, соединения и группировки. Проверьте, что запрос возвращает ожидаемые строки на тестовом периоде и с реальными данными.

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

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

Создание формы запроса в конфигурации

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

Если форма должна открываться из справочника, документа или журнала, создайте команду и укажите форму запроса в качестве целевой. При открытии можно передавать начальные значения параметров, чтобы пользователь сразу видел отфильтрованный набор данных.

Настройка отбора и вывода

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

Открытие формы из интерфейса

Проверьте команду открытия формы в пользовательском интерфейсе. Форма должна появляться как модальное или обычное окно в зависимости от настроек. После открытия убедитесь, что данные отображаются без задержек и соответствуют выбранным параметрам.

Программное создание и открытие формы запроса

Если форма нужна только внутри одной обработки или внешней компоненты, её можно создать программно. Создайте объект формы запроса, задайте текст запроса и значения параметров, затем вызовите открытие формы. Такой способ удобен для встраивания в кнопки обработок без изменения общей конфигурации.

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

Особенности модального и обычного открытия

Модальное окно блокирует работу с основным окном до закрытия формы, что подходит для быстрой проверки. Обычное окно позволяет пользователю переключаться между формами, но требует внимательного управления жизненным циклом объекта. Выбирайте вариант в зависимости от сценария работы.

Параметры, отбор и проверка результата

Параметры запроса должны иметь понятные имена и соответствовать типам данных полевых условий. Даты передавайте в формате, поддерживаемом платформе, а ссылки на справочники — в виде объектов конфигурации. Не передавайте в параметры текстовые условия, если их можно выразить через структуры запроса.

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

Типичные ошибки и ограничения

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

Типичные ошибки
01
Отсутствие ограничения по периоду приводит к большой выборке и медленной работе
02
Игнорирование прав доступа воспринимается как ошибка запроса, хотя причина в ролях пользователя

Другая ошибка — игнорирование прав доступа. Пользователь может открыть форму, но не видеть строк из регистров, к которым нет доступа. Это выглядит как пустой результат, хотя данные существуют. Проверяйте права доступа отдельно от текста запроса.

Форма запроса обычно поддерживает ограниченное форматирование и не заменяет отчёт с группировками, диаграммами и печатью. Если нужны сложные вычисления или итоговые строки, вынесите их в запрос или используйте отчёт. Не пытайтесь встроить в форму запроса бизнес-логику, для которой не предусмотрены события.

Контрольные точки

Как проверить результат

Результат формы на тестовом периоде
Норма

Строки соответствуют исходным регистрам и справочникам

Тревожный признак

Пустая таблица при наличии данных или лишние строки из-за отсутствия отбора

Права доступа пользователя
Норма

Видно ожидаемые строки без сообщений о доступе

Тревожный признак

Пустой результат при известном наличии данных

Безопасная самостоятельная работа и границы ответственности

Создание формы запроса в собственной конфигурации или копии с поддержкой безопасно при условии резервного копирования и тестирования на отдельной базе. Изменения в типовых объектах без понимания механизмов обновления могут привести к потере правок и ошибкам при поддержке.

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

Итог

Что важно запомнить

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

Часто задаваемые вопросы

Можно ли редактировать данные через форму запроса?

Редактирование зависит от состава запроса и источников данных. В общем случае форма запроса предназначена для просмотра; прямое изменение регистров через такую форму ограничено и не всегда поддерживается.

Нужно ли программировать, чтобы создать форму запроса?

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

Что делать, если форма показывает пустую таблицу?

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

Подходит ли форма запроса для ежемесячных отчётов?

Для регулярных отчётов с оформлением, печатью и отправкой лучше использовать отчёт или обработку. Форма запроса удобнее для разовой проверки и быстрого отбора данных.