Другое · 9 мин
Как из одной формы 1С обратиться к другой
Как из одной формы 1С обратиться к другой: владелец при открытии, ссылка на форму, общие формы и модули, модальность, права и клиент-сервер в 1С:Предприятие
В managed-приложении 1С форма не является глобальным объектом, к которому можно обратиться по имени из любого места. Каждая форма существует в контексте сессии, имеет владельца и может быть открыта модально или немаодально. Поэтому основной вопрос не в том, «найти форму по имени», а в том, какая связь между формами установлена и кто имеет право инициировать вызов.
Если форма Б открыта формой А, то у Б обычно есть свойство владельца, через которое можно обратиться к А. Если же формы открыты независимо, прямая ссылка может отсутствовать, и тогда используются параметры открытия, общие модули, сеансовые параметры, справочники регистрации сведений или события. Выбор способа зависит от того, кто инициирует взаимодействие и нужно ли дожидаться закрытия второй формы.
Прямая ссылка на форму удобна для близко связанных объектов, например карточки и списка, но создаёт жёсткую зависимость. При изменении интерфейса или переносе формы в другую конфигурацию такие вызовы могут перестать работать. Ниже разобраны основные сценарии, условия их применения и признаки, при которых прямой доступ лучше не использовать.
Когда прямой доступ к форме уместен
Прямой доступ оправдан, когда одна форма открывает другую и после открытия нужно передать данные, вызвать метод или дождаться результата. Типичный пример: из списка контрагентов открывается карточка элемента, пользователь вносит изменения, а список должен обновиться после закрытия карточки. В таких случаях связь «родитель — потомок» уже существует, и дополнительный поиск формы не требуется.
Если формы не связаны открытием, прямая ссылка может быть недоступна. Например, две независимые формы открыты пользователем в разных окнах; у одной нет свойства владельца, указывающего на другую. Тогда попытка обратиться по имени формы приведёт к ошибке или получению неопределённого значения. Нужно либо явно передать ссылку при открытии, либо использовать общий механизм обмена данными.
Открыть форму и получить владельца
Частый сценарий: форма А открывает форму Б, передавая себя в качестве владельца. В коде формы А это выглядит примерно так:
ОткрытьФорму("Форма.Справочник.Контрагенты.ФормаЭлемента", Новая Структура("Ключ", КлючКонтрагента), ЭтаФорма);
В открытой форме Б обращение к владельцу выполняется через свойство, которое возвращает форму или объект, инициировавший открытие. Через него можно вызвать доступную процедуру родительской формы, например обновить выбор или передать выделенный объект. Если процедура отсутствует или недоступна, возникнет ошибка, поэтому перед вызовом полезно убедиться, что метод существует.
Обратное направление тоже возможно: форма А сохраняет ссылку, возвращаемую при открытии, и позже вызывает метод формы Б. Примерно так:
СсылкаНаФорму = ОткрытьФорму("Форма.Документ.РеализацияТоваров.ФормаДокумента", , ЭтаФорма);
СсылкаНаФорму.УстановитьКонтрагента(ТекущийКонтрагент);
Важно: ссылку на форму нельзя хранить в глобальном переменном объекте на долгое время и использовать из разных сессий. Форма привязана к окну и сессии клиента; после закрытия ссылка становится недействительной. Проверяйте результат открытия и не вызывайте методы закрытой формы.
- 1Открыть целевую форму, передав текущую форму в параметр владельца.
- 2В целевой форме обратиться к свойству владельца для доступа к родительской форме.
- 3Вызвать только доступную публичную процедуру или функцию родительской формы.
- 4Проверить, что форма не закрыта и у пользователя есть права на целевой объект.
Вызвать форму, которую открыла текущая форма
Если форма А сама открыла форму Б и сохранила ссылку, то у А есть прямой путь к Б. Это удобно для передачи выбранного значения, открытия дополнительного окна или запуска проверки перед сохранением. Ссылку следует использовать сразу в рамках той же сессии и не сохранять её после закрытия формы Б.
Если ссылка не сохранена, а форма уже открыта, получить её повторно через системный поиск по имени обычно нельзя. Нужно либо открыть форму заново, либо организовать обмен через общие данные. При повторном открытии может появиться второе окно одной и той же формы, что приведёт к дублированию данных и путанице пользователя.
Признак корректной работы: форма Б открывается, метод из формы А отрабатывает без ошибки, данные передаются в нужные реквизиты. Признак проблемы: ошибка при обращении к свойству владельца, метод не найден, форма открывается в отдельном окне без связи с вызывающей.
Общие формы и формы без владельца
Некоторые формы относятся к общим и могут быть получены через стандартные механизмы получения формы без привязки к конкретному объекту. Это подходит для справочных или служебных окон, которые не зависят от текущего документа. Для форм объектов, привязанных к конкретному контрагенту или документу, общий доступ без владельца не даст нужного контекста.
Если обе формы открыты пользователем независимо, прямая ссылка между ними чаще всего отсутствует. В этом случае целевая форма может получить данные через параметры открытия, сеансовые параметры, временное хранилище или регистр сведений. Форма А записывает значение, форма Б читает его при открытии. Такой подход слабее связан с интерфейсом и проще переносит изменения.
Общие модули позволяют вынести общую логику за пределы форм. Форма А вызывает процедуру общего модуля, записывает результат, форма Б вызывает другую процедуру и читает результат. Это не является прямым обращением к форме, но часто решает ту же задачу без риска ссылки на закрытое окно.
Сравнение вариантов связи форм
Подходит для форм, открытых одной другой; быстро и напрямую, но требует хранения ссылки и проверки на закрытие.
Подходит для независимых форм и сложных конфигураций; менее жёсткая зависимость, но требует дополнительного кода для записи и чтения данных.
Модальность, права и контекст выполнения
Модальная форма блокирует владельца до своего закрытия. Если форма А открывает форму Б модально, код в А после вызова ОткрытьФорму выполнится только после закрытия Б. Это удобно, когда нужно обязательно получить результат, но недопустимо, если пользователь должен одновременно работать в обеих формах. Немаодальное окно позволяет параллельную работу, но тогда результат нужно получать по событиям или через общие данные.
Права доступа проверяются не только к форме, но и к лежащему в её основе объекту: справочнику, документу, регистру. Даже если форма открыта, пользователь может не иметь права читать реквизит или вызывать процедуру. Ошибка доступа может выглядеть как отсутствие метода, хотя на самом деле причина в правах. Проверяйте права и роли перед тем, как делать вывод о неисправности кода.
Формы относятся к клиентскому контексту. Прямой вызов процедуры формы из серверного метода или фонового задания невозможен без клиентского вызова и активного окна. Не пытайтесь управлять формой напрямую из серверной части; используйте клиентские процедуры, уведомления или передачу результата через параметры.
Альтернативы без прямой ссылки на форму
Когда прямая связь неудобна или невозможна, используйте косвенный обмен. Форма А сохраняет идентификатор объекта в сеансовый параметр или временную таблицу, форма Б при открытии читает этот параметр и загружает данные. Это работает даже если формы открыты в разных окнах и не знают друг о друге.
События и подписки также могут связывать формы без прямой ссылки: одна форма регистрирует изменение, другая подписывается на уведомление и обновляет табличную часть. Такой подход требует осторожности, так как избыточные подписки приводят к лишним пересчётам и замедлению работы.
Граница безопасной самостоятельной работы: изменение вызова формы, передача параметров и вызов публичной процедуры той же формы. Смена архитектуры форм, перенос логики между клиентом и сервером, изменение прав доступа лучше проводить в копии конфигурации с тестированием на реальных ролях.
Что важно запомнить
Используйте владельца и сохранённую ссылку для связанных форм, общие модули и параметры для независимых, учитывайте модальность, права и клиентский контекст.
Можно ли открыть форму по имени из любой другой формы?
Нет, не всегда. Форма должна быть открыта в текущей сессии, и у вызывающей формы должна быть ссылка на неё через владельца, параметр открытия или общий механизм. Простого обращения по имени формы из любого места в managed-приложении обычно нет.
Что делать, если форма открыта, но доступ к ней отсутствует?
Проверьте, является ли форма владельцем или была ли ссылка сохранена при открытии. Если нет, передайте данные через параметры, сеансовые параметры, временное хранилище или общий модуль. Также убедитесь, что у пользователя есть права на целевой объект.
В чем разница между модальным и немаодальным открытием?
Модальная форма блокирует вызывающую форму до закрытия, что подходит для обязательного получения результата. Немаодальная форма позволяет работать в обоих окнах одновременно, но результат нужно получать через события или общие данные, а не ждать завершения кода сразу после открытия.
Можно ли управлять формой из серверного метода?
Прямое управление клиентской формой из серверного контекста невозможно без клиентского вызова и активного окна. Используйте клиентские процедуры, передавайте результат через параметры или используйте уведомления, а не обращайтесь к форме напрямую с сервера.
Нужно ли тестировать изменения в копии конфигурации?
Да, если вы меняете способы связи форм, права доступа или переносите логику между клиентом и сервером. Проверяйте на ролях пользователей, в копии конфигурации и только после этого переносите в рабочую базу.