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

Другое · 6 мин

Передача параметра в динамический список в 1С

Как передать параметр в динамический список 1С: через отбор, параметры формы и команды, проверка отбора, ограничения и типичные ошибки.

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

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

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

Когда динамическому списку нужен параметр

Параметр нужен, когда список должен показывать только подмножество данных, связанное с текущим контекстом. Например, при выборе контрагента из списка договоров отображаются только договоры этого контрагента, а при выборе номенклатуры из списка заказов — только позиции по выбранному заказу.

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

Способы передачи параметра в динамический список

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

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

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

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

Передача через отбор и настройку списка

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

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

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

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

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

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

Не рекомендуется хранить ссылки на объекты в глобальных переменных только для передачи в список. Лучше передавать значение явно через параметры открытия, чтобы избежать проблем при многократном открытии и работе в разных клиентских вариантах.

Проверка результата и ограничения

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

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

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

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

Открытый список
Норма

Показаны только записи по переданному параметру

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

Показаны все записи или список пуст без причины

Тип параметра
Норма

Соответствует типу реквизита отбора

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

Несоответствие типов или ошибка при открытии

Права доступа
Норма

Пользователь видит ожидаемые записи

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

Список пуст из-за ограничения прав

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

Частые ошибки и безопасная работа

Частая ошибка — задать значение отбора, но забыть включить его использование. Внешне код выглядит правильно, но список открывается без фильтра. Всегда проверяйте оба свойства: значение и признак использования.

Типичные ошибки
01
Значение отбора задано, но использование отбора выключено
02
Передан параметр неверного типа для реквизита фильтрации
03
Отбор изменён после открытия списка без обновления данных

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

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

Итог

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

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

Нужно ли программировать передачу параметра в стандартную конфигурацию?

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

Можно ли передать несколько параметров в один динамический список?

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

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

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

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

Обычно да, если у пользователя есть права на чтение этих документов. Избегайте передачи объектов, которые ещё не сохранены, и не используйте параметры для передачи данных, недоступных данному пользователю по правам.