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