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

Другое · 6 мин

Запуск процедуры из другой формы в 1С

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

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

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

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

Когда прямой вызов формы уместен

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

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

Как получить ссылку на целевую форму

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

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

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

Вызов процедуры и передача параметров

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

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

1c
&НаКлиенте Процедура ВызватьПроцедуруДругойФормы() Форма = ПолучитьФорму("Форма.Товары", , ЭтаФорма); Если Форма <> Неопределено Тогда Форма.МояПроцедура(Параметр); КонецЕсли; КонецПроцедуры

Если форма уже открыта

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

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

Если форму нужно открыть перед вызовом

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

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

Ограничения клиент-серверного контекста

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

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

Альтернативы прямому вызову

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

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

Типичные ошибки
01
Вызов несуществующей ссылки на форму без проверки на неопределённое значение
02
Передача параметров в неверном контексте клиент-сервер
03
Изменение конфигурации без резервной копии и тестирования на копии базы

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

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

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

Итог

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

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

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

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

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

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

Что делать, если форма открыта в другом клиенте?

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

Безопасно ли менять конфигурацию на рабочей базе?

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