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