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

Другое · 6 мин

Как передать параметр в уже открытую форму в 1С:Предприятии

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

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

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

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

Когда передача параметра в открытую форму оправдана

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

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

Способ через общий модуль и реестр открытых форм

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

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

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

Отличие от передачи параметров при открытии формы

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

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

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

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

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

Ограничения, риски и многопользовательский режим

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

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

Типичные ошибки
01
Передача параметра без регистрации формы в общем модуле — ссылка на окно недоступна
02
Невременная очистка реестра — накапливаются ссылки на закрытые формы

Типичные ошибки

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

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

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

Параметр при открытии

Подходит для первоначальной настройки, не работает для уже открытого окна

Реестр открытых форм

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

Общее хранилище данных

Надежно при закрытых окнах, но форма узнает параметр не мгновенно

Выбор способа и альтернативы

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

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

Итог

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

Параметр в уже открытую форму передают через общую точку хранения и вызов процедуры формы, а не через повторное ОткрытьФорму.

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

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

Что делать, если форма уже закрыта к моменту передачи параметра?

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

Можно ли передать параметр форме другого пользователя?

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

Какая процедура формы должна принимать параметр?

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