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