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

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

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

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

1. Визуальные отличия обычных и управляемых форм

Самый быстрый способ определить тип формы — обратить внимание на её внешний вид и поведение. Управляемые формы имеют ряд характерных особенностей, которые отсутствуют у обычных. Вот ключевые признаки:

• 🔹 Панель навигации: Управляемые формы всегда содержат стандартную панель с кнопками Записать, Закрыть, Ещё и другими. В обычных формах панель инструментов настраивается вручную и может выглядеть иначе.
• 🔹 Адаптивность: Управляемые формы автоматически подстраиваются под размер окна, тогда как обычные часто требуют ручной настройки положения элементов.
• 🔹 Контекстное меню: При клике правой кнопкой мыши на элемент управляемой формы появляется стандартное меню с пунктами Копировать, Вырезать, Вставить. В обычных формах такое меню может отсутствовать или быть кастомизированным.
• 🔹 Стиль элементов: Кнопки, поля ввода и другие элементы в управляемых формах имеют современный плоский дизайн (в стиле 1С:Такси), тогда как обычные формы используют устаревший "классический" интерфейс.

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

⚠️ Внимание: В некоторых конфигурациях (например, 1С:УТ 10.3 или 1С:БП 2.0) обычные формы могут имитировать управляемые с помощью дополнительных обработок. Визуально их почти невозможно отличить — требуется анализ кода.

2. Определение типа формы через конфигуратор

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

1. Откройте конфигуратор в режиме 1С:Предприятие (с правами администратора).
2. Перейдите в дерево метаданных и найдите объект, для которого нужно определить тип формы. Это может быть справочник, документ, отчёт или другой объект.
3. Раскройте ветку объекта и найдите подраздел Формы. Здесь будут перечислены все формы, связанные с объектом.
4. Кликните правой кнопкой мыши на нужную форму и выберите Свойства. В открывшемся окне будет поле Тип с значением Управляемая форма или Обычная форма.

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

• 📌 В конфигурациях на базе БСП 2.х/3.х (например, 1С:ERP, 1С:КА 2) формы по умолчанию — управляемые.
• 📌 В устаревших конфигурациях (например, 1С:Торговля 7.7 или 1С:Бухгалтерия 1.6) — обычные.

Открыть конфигуратор с правами администратора|

Найти объект в дереве метаданных|

Раскрыть ветку "Формы"|

Просмотреть свойство "Тип" в окне свойств формы-->

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

3. Программное определение типа формы (встроенный язык)

Для опытных разработчиков самый надёжный способ — проверка типа формы через встроенный язык 1С. Этот метод работает в любом режиме (тонкий клиент, толстый клиент, веб-клиент) и не зависит от визуальных настроек. Ниже приведён универсальный код, который можно выполнить в отладчике или встроить в обработку:

// Получаем текущую форму
ТекущаяФорма = ЭтотОбъект;

// Проверяем тип формы
Если ТипЗнч(ТекущаяФорма) = Тип("УправляемаяФорма") Тогда
Сообщить("Это управляемая форма!");
ИначеЕсли ТипЗнч(ТекущаяФорма) = Тип("Форма") Тогда
Сообщить("Это обычная форма!");
Иначе
Сообщить("Это не форма или неизвестный тип!");
КонецЕсли;

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

// Пример для документа "ЗаказПокупателя"
Док = Документы.ЗаказПокупателя.СоздатьДокумент();
ФормаОбъекта = Док.ПолучитьФорму();

// Проверяем тип
Если ТипЗнч(ФормаОбъекта) = Тип("УправляемаяФорма") Тогда
// Логика для управляемой формы
Иначе
// Логика для обычной формы
КонецЕсли;

Для динамически создаваемых форм (например, через ОткрытьФорму()) тип можно определить по имени модуля формы:

ИмяМодуля = Форма.ИмяМодуля();
Если СтрНачинаетсяС(ИмяМодуля, "УправляемаяФорма") Тогда
// Это управляемая форма
КонецЕсли;

⚠️ Внимание: В некоторых случаях (например, при работе с внешними обработками) форма может не иметь явного типа. Тогда проверяйте наличие характерных методов, например, ПолучитьКоманднуюПанель() — он есть только у управляемых форм.

4. Сравнительная таблица: обычные vs управляемые формы

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

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

5. Особенности определения типа формы в типовых конфигурациях

В типовых конфигурациях от 1С (например, 1С:Бухгалтерия 3.0, 1С:ЗУП 3.1, 1С:ERP 2.5) большинство форм уже переведено на управляемый интерфейс. Однако в некоторых модулях (особенно в старых версиях) могут сохраняться обычные формы. Вот несколько нюансов для типовых решений:

• 🔧 В 1С:УТ 11 и 1С:КА 2 все основные формы (документов, справочников, отчётов) — управляемые. Обычные формы могут встречаться только в подсистемах, перенесённых из старых версий.
• 🔧 В 1С:БП 3.0 обычные формы можно найти в модулях обмена данными или в обработках, написанных до 2015 года.
• 🔧 В 1С:Розница 2.3 обычные формы практически не используются, за исключением некоторых печатных форм.

Чтобы быстро найти все обычные формы в типовой конфигурации, воспользуйтесь поиском по метаданным:

1. Откройте конфигуратор и нажмите Ctrl + Shift + F (поиск по метаданным).
2. В поле Тип объекта выберите Форма.
3. В поле Тип укажите Обычная форма.
4. Запустите поиск — система покажет все обычные формы в конфигурации.

⚠️ Внимание: В некоторых типовых конфигурациях (например, 1С:Медицина) обычные формы могут быть скрыты в подсистемах интеграции с внешними системами. Их модификация без согласования с вендором может привести к проблемам при обновлении.

6. Практические сценарии: когда нужно знать тип формы

Знание типа формы не просто академический интерес — оно критично в ряде практических ситуаций. Рассмотрим наиболее распространённые сценарии, где определение типа формы становится необходимостью:

• 🛠️ Миграция с обычных форм на управляемые: При переходе на современный интерфейс нужно точно знать, какие формы требуют переработки. Автоматические инструменты (например, КонвертацияФорм из БСП) не всегда справляются с сложными формами.
• 🐞 Отладка наследуемого кода: Если вы поддерживаете старую систему, где смешаны оба типа форм, понимание их типа поможет избежать ошибок при модификации.
• 📊 Оптимизация производительности: Управляемые формы лучше работают в тонком клиенте, а обычные могут быть быстрее в толстом при больших объёмах данных.
• 🔄 Интеграция с внешними системами: Некоторые API и обработки (например, для обмена данными) могут требовать конкретный тип формы.

Пример из практики: при интеграции 1С с Bitrix24 через REST API может потребоваться открытие формы документа в управляемом режиме, так как обычные формы не поддерживают некоторые методы работы с HTTP-Сервисами. Если не учесть это заранее, интеграция просто не заработает.

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

7. Частые ошибки при работе с типами форм

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

• ❌ Попытка открыть обычную форму в тонком клиенте: Это приведёт к ошибке "Форма не может быть открыта в данном клиенте". Всегда проверяйте тип формы перед открытием:

  Если ТипЗнч(Форма) = Тип("УправляемаяФорма") Тогда
  ОткрытьФорму(Форма);
  Иначе
  Предупреждение("Эта форма не поддерживается в тонком клиенте!");
  КонецЕсли;

• ❌ Использование методов управляемых форм в обычных: Например, вызов ПолучитьКоманднуюПанель() в обычной форме вызовет ошибку. Перед вызовом проверяйте наличие метода через Метаданные().Методы.Найти().
• ❌ Неучёт контекста выполнения: Код, работающий в модуле обычной формы, не будет работать в управляемой, если в нём используются специфичные для типа формы объекты (например, ЭлементыФормы vs Элементы).
• ❌ Игнорирование механизма расширений: При модификации обычных форм в типовых конфигурациях нередко "ломают" обновления, редактируя формы напрямую. Всегда используйте Расширения конфигурации.

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

// Опасный код - тип формы не проверяется!
Процедура ОбработатьФорму(Форма)
Форма.МетодТолькоДляУправляемыхФорм(); // Может упасть!
КонецПроцедуры

// Безопасный вариант
Процедура ОбработатьФормуБезопасно(Форма)
Если ТипЗнч(Форма) = Тип("УправляемаяФорма") Тогда
Форма.МетодТолькоДляУправляемыхФорм();
КонецЕсли;
КонецПроцедуры

FAQ: Ответы на частые вопросы

Сообщить(?(
ТипЗнч(ЭтаФорма) = Тип("УправляемаяФорма"),
"Управляемая форма: " + ЭтаФорма.Имя,
"Обычная форма: " + ЭтаФорма.Имя
));

ТекущаяФорма = Формы.АктивнаяФорма();
Если ТекущаяФорма <> Неопределено Тогда
Сообщить(ТипЗнч(ТекущаяФорма));
КонецЕсли;