Просмотреть управляемую форму и перейти к обработчику
Как посмотреть структуру управляемой формы загруженной обработки — элементы, реквизиты, команды, связи — и перейти к коду обработчика в модуле формы.
Перед чтением
- Открыть модуль или форму Руководство
На этой странице
Для обработок и отчётов с управляемыми формами на этапе Source есть вкладка «Форма (УФ)». Она показывает, из чего состоит форма: дерево элементов, реквизиты, команды, параметры и связи элементов с реквизитами, командами и обработчиками. Отсюда можно перейти к коду обработчика в модуле формы.
Вкладка служит только для просмотра: менять расположение элементов, добавлять реквизиты или команды здесь нельзя. Код обработчиков правится в редакторе BSL, как любой модуль.
Когда это нужно#
- Вы загрузили чужую обработку и хотите понять, какие элементы и команды есть на форме.
- Нужно найти, какая процедура модуля формы срабатывает при нажатии кнопки или изменении поля.
- Нужно проверить, на какой реквизит ссылается элемент формы.
Перед началом#
- Загружен файл
.epfили.erfс управляемыми формами (Загрузить файл .epf или .erf), и открыт любой его модуль (Открыть модуль или форму). - Для обработки, созданной в Studio с нуля, вкладка покажет «Обычные формы (ОФ)» и список форм: новый файл всегда создаётся с обычной формой, а просмотр рассчитан на управляемые формы. Разница между видами форм — Обычные и управляемые формы в Studio.
Шаги#
- На этапе Source нажмите вкладку «Форма (УФ)».
- В поле «Управляемая форма» выберите форму. Рядом показан путь к модулю этой формы.
- Переключайте вкладки:
- «Дерево» — элементы формы в порядке вложенности: тип, имя, путь к данным и имя команды, если они заданы;
- «Реквизиты» — имя, заголовок и тип каждого реквизита формы;
- «Команды» — имя команды, заголовок и обработчик действия;
- «Параметры» — параметры формы и их типы;
- «Связи» — сводка по ссылкам элементов на реквизиты, команды и обработчики событий.
- Чтобы перейти к коду обработчика, на вкладке «Команды» или «Связи» (таблица «Обработчики») нажмите «→ BSL» в нужной строке.
- Studio переключится на вкладку «Формы», откроет модуль выбранной формы и поставит курсор на объявление процедуры. Появится уведомление вида «BSL · ТекстЗапросаПриИзменении · стр. 203».
Результат#
Модуль формы открыт в редакторе на строке обработчика. Дальше с ним работают как с обычным модулем: правят, ищут другие процедуры (Найти процедуру или функцию) и сохраняют кнопкой «Сохранить BSL» (Сохранить изменения BSL). Чтобы вернуться к просмотру формы, снова нажмите «Форма (УФ)».
Как читать вкладку «Связи»#
У каждой ссылки есть отметка состояния:
| Отметка | Что означает |
|---|---|
| «OK» | Studio нашла то, на что указывает ссылка: реквизит, команду или процедуру в модуле. |
| «BROKEN» | Ссылка указывает на то, чего Studio не нашла, — например, на обработчик, которого нет в модуле. Проверьте это место в Конфигураторе. |
| «UNKNOWN» | Studio не смогла разобрать эту часть описания формы; в строке может стоять «не декодирован». Это ограничение просмотра, а не ошибка формы. |
Кнопка «→ BSL» есть только у строк, где указан обработчик и его удалось разобрать.
Ограничения#
- Просмотр неполный: часть свойств элементов не разбирается и отмечается «UNKNOWN».
- Макет формы не редактируется и не конвертируется между обычной и управляемой формой.
- Пояснение над просмотром и строка с процентами разбора — служебные; на работу не влияют.
Если не получилось#
| Что видно | Что сделать |
|---|---|
| «Обычные формы (ОФ)» и список имён форм | В файле только обычные формы. Просмотр для них не предусмотрен — откройте модуль формы на вкладке «Формы». |
| Уведомление «Процедура «…» не найдена в модуле формы (нет в BSL или имя не совпало)» | В модуле формы нет процедуры с таким именем. Найдите похожее имя через «Найти процедуру или функцию…» (Найти процедуру или функцию) или проверьте форму в Конфигураторе. |
| Уведомление «Модуль формы не найден в Source» | У выбранной формы нет модуля в файле. Выберите другую форму. |
| Вместо просмотра — сообщение об ошибке загрузки | Обновите страницу и снова откройте вкладку «Форма (УФ)». Если не помогло, загрузите файл повторно (Загрузить файл .epf или .erf). |
См. также
- Source Справочник
- Обычные и управляемые формы в Studio Понятие
- Найти процедуру или функцию Руководство
- Сохранить изменения BSL Руководство
Сверено с продуктом: 27.10.2026