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

Другое · 8 мин

Как использовать форму из расширения в 1С

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

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

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

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

Когда форма из расширения доступна для использования

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

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

Расширение подключеноФормы расширения видны в интерфейсе

Проверьте список подключённых расширений и их статус

Расширение выключеноФормы расширения недоступны

Активируйте расширение и обновите сеанс

Имена форм совпадаютМожет открыться форма базовой конфигурации

Уточните приоритет расширений и точное имя формы

Открытие формы через интерфейс пользователя

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

Управляемая форма

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

Обычная форма и веб-клиент

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

Программное открытие формы из расширения

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

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

Порядок действий
  1. 1
    Убедитесь, что расширение подключено и активно
  2. 2
    Откройте форму через интерфейс или программно с правильным именем объекта и формы
  3. 3
    Проверьте, открылась ли форма из расширения, а не базовая
  4. 4
    Проверьте права пользователя на объект и форму
  5. 5
    Зафиксируйте результат и протестируйте на копии базы

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

Права доступа и видимость форм расширений

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

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

Ограничения, конфликты и проверка результата

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

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

Типичные ошибки
01
Попытка использовать форму без подключённого расширения приводит к отсутствию формы в интерфейсе
02
Редактирование базовой конфигурации вместо расширения может привести к потере изменений при обновлении
03
Открытие формы без проверки прав вызывает ошибки доступа у обычных пользователей

Безопасная работа и обновление расширений

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

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

Итог

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

Форма из расширения работает только при активном подключённом расширении; открывайте её через интерфейс или код, проверяйте права, приоритеты и тестируйте на копии базы.

Нужно ли перезапускать 1С после подключения расширения, чтобы форма появилась?

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

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

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

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

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

Как отличить форму расширения от формы базовой конфигурации?

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

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

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