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

Другое · 8 мин

Как передать параметр в форму выбора в 1С: инструкция

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

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

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

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

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

Что можно передать через параметры формы

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

1c
Параметры = Новый Структура;
Параметры.Вставить("КлючКонтрагента", Контрагент);
ОткрытьФорму("Справочник.Контрагенты.ФормаВыбора", Параметры, ЭтаФорма);

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

Как открыть форму выбора с параметром

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

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

Чтение параметра внутри формы выбора

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

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

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

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

Типичные ошибки
01
Попытка изменить параметр уже открытой формы стандартными средствами
02
Чтение параметра после создания формы, когда коллекция уже недоступна
03
Игнорирование различий между управляемой и обычной формой
04
Прямое редактирование типовой формы без резервной копии

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

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

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

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

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

Список после открытия формы
Норма

Отфильтрован по переданному параметру или выделена нужная строка

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

Список открыт без отбора или появилась ошибка при чтении параметра

Работа без параметра
Норма

Форма открывается в обычном режиме

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

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

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

Как проверить, что параметр передан верно

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

Сравнение вариантов

Управляемая форма

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

Обычная форма

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

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

Сравнение управляемой и обычной формы

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

Итог

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

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

Частые вопросы и ответы

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

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

Отличается ли порядок для управляемых и обычных форм?

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

Почему переданный параметр не виден в форме?

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

Как вернуть выбранное значение вызывающей форме?

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

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

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