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

Другое · 8 мин

Как открыть форму выбора с отбором в 1С 8

Как в 1С:Предприятие 8 открыть форму выбора и передать отбор: управляемые формы, параметры ОткрытьФорму, проверка результата и типичные ошибки.

В управляемом приложении 1С:Предприятие 8 форма выбора чаще всего открывается программно: из команды формы, обработчика события, внешней обработки или общего модуля. Основной инструмент — вызов метода ОткрытьФорму, в который передаётся имя формы и структура параметров. Если нужно ограничить доступный список, в параметры добавляется отбор по одному или нескольким реквизитам.

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

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

Когда форма выбора открывается с отбором

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

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

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

Параметры вызова и структура отбора

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

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

Сценарий: выбор контрагента из справочника

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

Сценарий: отбор по дате и сумме

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

Открытие из списка и из документа

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

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

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

После закрытия формы выбора код должен проверить, нажал ли пользователь «ОК» или «Выбрать», и есть ли выделенная запись. Если пользователь отменил выбор, дальнейшая обработка не должна выполняться, иначе может быть использовано пустое или некорректное значение. Результат часто возвращается в виде ссылки, строки или неопределённого значения в зависимости от типа формы.

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

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

Ограничения и права доступа

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

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

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

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

Форма открывается и показывает отфильтрованный список
Норма

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

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

Пустой список или все записи без фильтра

Типичные ошибки и что делать, если отбор не применяется

Самая частая причина неработающего отбора — несоответствие имени реквизита в коде и в форме. Реквизит может называться по-разному в справочнике, в форме и в запросе. Вторая причина — отбор задаётся после того, как данные уже загружены, и форма не перечитывает список. Третья — права доступа скрывают подходящие записи, поэтому отбор формально существует, но результат пуст.

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

Итог

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

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

Альтернативы и редкие случаи

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

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

Нужно ли программирование для открытия формы с отбором?

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

Можно ли задать несколько условий отбора одновременно?

Да, если форма поддерживает составной отбор. Условия объединяются по логике «и» или «или» в зависимости от реализации формы. Точный способ задания нескольких условий зависит от конфигурации.

Почему форма открывается, но список пустой?

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

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

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