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