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

Другое · 8 мин

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

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

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

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

Самостоятельно можно выполнить перевод типовых и несложных форм, если в конфигурации есть доступ к режиме «Конфигуратор» и понимается назначение объекта. Для сложных форм с большим количеством вложенных таблиц, внешних обработок и интеграций лучше привлечь разработчика 1С. Ниже описан порядок действий, условия, ограничения и способы проверки результата.

Когда переход на управляемую форму оправдан

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

Признаки, что форма нуждается в переводе

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

Когда от перехода стоит воздержаться

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

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

Подготовка и анализ обычной формы

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

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

Создание управляемой формы и перенос элементов

В Конфигураторе для объекта создаётся новая форма с типом «Управляемая форма». На основе списка, составленного на этапе анализа, переносятся элементы управления: поля ввода, кнопки, команды, табличные части и группы. Расположение элементов может отличаться от обычной формы, поэтому интерфейс приходится верстать заново в конструкторе управляемых форм.

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

Перенос модуля и команд

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

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

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

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

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

Проверка результата и ограничения

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

Типичные ошибки
01
Удаление обычной формы до проверки новой управляемой формы
02
Перенос кода без учёта контекста клиента и сервера
03
Забыть обновить все вызовы формы в командах и обработках

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

ПараметрОбычная формаУправляемая форма
Основной клиентТолстый клиентТонкий, веб, мобильный
Перенос между формамиНе автоматическийТребуется ручной перенос элементов и кода
ТестированиеВ обычном приложенииВ каждом целевом клиенте отдельно

Частые ошибки и как их избежать

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

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

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

Открытие формы
Норма

Форма открывается в целевом клиенте без ошибок

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

Ошибка при открытии или форма отсутствует

Сохранение данных
Норма

Значения реквизитов сохраняются после записи

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

Данные не сохраняются или сбрасываются

Работа команд
Норма

Кнопки и команды выполняют заданные действия

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

Команды не реагируют или вызывают ошибку

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

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

Итог

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

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

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

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

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

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

Где тестировать новую форму?

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

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

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