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