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

Другое · 8 мин

Как в 1С узнать, откуда открыта форма

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

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

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

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

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

Что показывает платформа по умолчанию

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

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

ПризнакЕсть ли передача параметров при открытии

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

ПризнакИспользуется ли стандартная команда

При стандартном вызове без доработки источник обычно недоступен автоматически.

ПризнакЕсть ли свойство Владелец

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

Передача ключа открытия при вызове формы

Перед вызовом целевой формы вызывающая форма создаёт структуру параметров и помещает в неё значение ключа открытия. Например, структура может содержать поле КлючОткрытия со значением «ИзДокументаРеализации» или «ИзСпискаКонтрагентов». Затем структура передаётся в параметры ОткрытьФорму вместе с формой-владельцем, если это требуется по способу открытия.

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

ОткрытьФорму("Справочник.Номенклатура.ФормаЭлемента", Новая Структура("КлючОткрытия", "ИзДокументаРеализации"), ЭтаФорма);

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

Типичные ошибки
01
Считать, что платформа всегда знает источник открытия формы; без передачи параметров это не так.
02
Использовать свойство Владелец как единственный источник для всех типов форм; оно не покрывает все сценарии.
03
Вносить изменения в типовую конфигурацию напрямую в рабочей базе без резервной копии и тестирования на копии.

Чтение параметров в открытой форме

В модуле целевой формы параметры доступа через объект Параметры в процедуре ПриОткрытии. Программа может получить значение ключа, сравнить его с известными константами и изменить видимость реквизитов, доступ к командам или заполнение полей. Например, при ключе «ИзДокумента» форма может автоматически заполнить ссылку на источник.

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

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

Когда форма открыта из списка или документа

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

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

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

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

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

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

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

Открытие из каждого сценария
Норма

Ключ открытия распознаётся, реквизиты заполнены корректно

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

Ключ отсутствует или заполнен неверный источник

Повторное открытие формы
Норма

Поведение стабильно, ошибок нет

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

Данные меняются непредсказуемо при повторном открытии

Проверка результата и альтернативы

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

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

Итог

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

Источник открытия формы в 1С определяется через переданные параметры и ключи, а не через встроенное свойство «откуда». Изменения проверяйте на копии базы, а типовую конфигурацию не правите без резервной копии.

Можно ли узнать источник открытия формы без программирования?

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

Работает ли Параметры.КлючОткрытия во всех случаях?

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

Что делать, если форма открывается из нескольких мест?

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

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

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