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

Разработка и Конфигурация · 11 мин

Как изменить заголовок формы в 1С

Как изменить заголовок формы в 1С: через конфигуратор, программно и без изменения конфигурации. Разбор для 8.3, управляемых и обычных форм, типовые ошибки.

Заголовок формы в 1С — это текст, который пользователь видит в шапке окна документа, справочника или отчёта. По умолчанию платформа формирует его автоматически: из синонима объекта метаданных, представления ссылки или заголовка команды. Когда стандартный вариант не устраивает — например, нужно показать номер и дату документа, статус заказа или понятное пользователю название вместо технического — заголовок меняют одним из нескольких способов.

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

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

Как платформа формирует заголовок по умолчанию

Прежде чем менять заголовок, полезно понять, откуда берётся текущий текст. Для формы объекта (документа, элемента справочника) платформа обычно показывает представление ссылки: например, «Реализация товаров и услуг 0000-000123 от 15.03.2026». Для формы списка — синоним объекта метаданных, заданный в конфигураторе. Для внешних обработок и отчётов — синоним или заголовок, указанный разработчиком.

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

Способ 1. Изменить синоним объекта в конфигураторе

Самый простой случай — нужно переименовать, как объект называется везде: в заголовках форм списка, в навигации, в подменю. Для этого откройте конфигуратор, найдите нужный объект в дереве конфигурации (например, «Справочники → Номенклатура»), вызовите палитру свойств и измените поле «Синоним». После обновления конфигурации базы данных новый текст появится в заголовках автоматически.

У способа есть ограничение: синоним — статичный текст. Он не может включать номер документа, дату или другие данные конкретного объекта. Если нужен динамический заголовок вида «Заказ № 154 от 12.05 — согласован», переходите к программным методам.

Способ 2. Программно задать заголовок управляемой формы

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

Пример кода для формы документа:

&НаСервере

Процедура ПриСозданииНаСервере(Отказ, СтандартнаяОбработка)

УстановитьЗаголовокФормы();

КонецПроцедуры

&НаСервере

Процедура УстановитьЗаголовокФормы()

Заголовок = СтрШаблон("Заказ поставщику № %1 от %2 (%3)",

Объект.Номер,

Формат(Объект.Дата, "ДЛФ=D"),

Объект.Статус);

КонецПроцедуры

Обратите внимание: присваивание заголовка выполняется на сервере, потому что данные объекта доступны именно там. Если нужно реагировать на изменение реквизита без записи — например, менять заголовок при смене статуса прямо в открытой форме — добавьте вызов клиентской процедуры из обработчика ПриИзменении поля, а в ней обновите Заголовок (свойство доступно и на клиенте).

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

Способ 3. Изменить заголовок обычной формы

В обычных формах (режим обычного приложения, встречается в старых конфигурациях) логика похожа, но обработчики другие. Заголовок устанавливают в ПриОткрытии или ПриПовторномОткрытии:

Процедура ПриОткрытии()

Заголовок = "Карточка контрагента: " + СокрЛП(Наименование);

КонецПроцедуры

Дополнительно в обычных формах у формы есть свойство АвтоЗаголовок. Если оно установлено в «Истина», платформа сама перезаписывает заголовок стандартным представлением, и ваши изменения будут затираться. Установите АвтоЗаголовок = Ложь перед присвоением своего текста.

Способ 4. Настроить представление объекта через стандартные обработчики

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

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

Минус метода — он влияет глобально на весь объект. Если нужно поменять заголовок только одной конкретной формы (например, формы подбора, но не основной формы элемента), используйте локальную установку заголовка в модуле именно этой формы.

Сравнение способов

Синоним в конфигураторе

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

Программно в модуле формы

Гибкий вариант для динамических заголовков одной формы. Требует изменения формы или расширения.

Представление объекта

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

Расширение конфигурации

Безопасно для типовых решений на поддержке. Ограничено возможностями расширений: не все формы и обработчики доступны.

Способ 5. Изменить заголовок через расширение конфигурации

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

&После("ПриСозданииНаСервере")

Процедура Расш1_ПриСозданииНаСервере(Отказ, СтандартнаяОбработка)

Заголовок = "Оформление заказа — " + Объект.Контрагент;

КонецПроцедуры

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

Как проверить результат и что делать, если заголовок не меняется

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

Если заголовок остался прежним, типичные причины такие: код размещён не в том обработчике (например, в клиентском, а данные объекта там недоступны); в обычной форме не отключён АвтоЗаголовок; изменения внесены в расширение, но оно не подключено или отключено по соображениям безопасности; пользователь смотрит на закэшированный сеанс — помогает перезапуск клиента.

Типичные ошибки
01
Присваивание заголовка на клиенте до чтения данных объекта — в заголовке пустые номер и дата
02
Забытый АвтоЗаголовок = Ложь в обычной форме — платформа затирает свой текст стандартным
03
Установка заголовка только в ПриСозданииНаСервере — после записи документа заголовок устаревает, нужен вызов и в ПослеЗаписиНаСервере
04
Правка типовой формы напрямую вместо расширения — конфликты и потеря изменений при обновлении
05
Изменение представления объекта вместо заголовка формы, когда нужно поменять только одну форму
Динамические заголовки с номером, датой и статусом удобны, когда у пользователя открыто много окон одного типа: по заголовку вкладки или окна он быстро находит нужный документ. Но не перегружайте заголовок — достаточно 2–3 ключевых реквизитов, иначе текст обрезается и теряет смысл.
ПЗ
Практическое замечание

Частые вопросы

Можно ли изменить заголовок формы без конфигуратора, в режиме Предприятия?

Нет, штатных пользовательских настроек заголовка формы в режиме Предприятия нет. Пользователь может менять видимость колонок списка и расположение элементов формы (если это разрешено), но текст заголовка задаётся только средствами разработки: в конфигураторе, программно или через расширение.

Почему заголовок сбрасывается после записи документа?

Потому что установка выполнена только в ПриСозданииНаСервере, который вызывается один раз при открытии. После записи данные объекта меняются (например, присваивается номер), а обработчик не повторяется. Продублируйте вызов процедуры установки заголовка в обработчике ПослеЗаписиНаСервере.

Как изменить заголовок формы списка, а не формы объекта?

Для формы списка работают те же приёмы: программная установка свойства Заголовок в ПриСозданииНаСервере модуля формы списка. Если нужно переименовать список глобально — измените синоним объекта метаданных: он используется и в заголовке формы списка, и в панели навигации.

Изменится ли заголовок в расширении, если поставщик обновит форму?

Расширение продолжит работать, но его нужно проверить после каждого обновления: если поставщик переименовал или удалил обработчик, к которому вы подключались аннотацией &После, расширение может перестать применяться или выдать ошибку. Контролируйте это при тестировании нового релиза на копии базы.

Можно ли сделать разные заголовки для разных пользователей?

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

Чем отличается заголовок формы от представления объекта?

Представление объекта — это строковое описание самого объекта (документа, элемента справочника), которое платформа показывает в ссылках, списках и по умолчанию в заголовке формы. Заголовок формы — свойство конкретной формы, которое можно задать независимо от представления. Меняя представление, вы влияете на объект везде; меняя заголовок — только на одну форму.

Итог

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

Статичный заголовок меняют через синоним объекта, динамический — присваиванием свойства Заголовок в модуле формы (ПриСозданииНаСервере и ПослеЗаписиНаСервере). В обычных формах отключайте АвтоЗаголовок. Для типовых конфигураций используйте расширение и проверяйте изменения на копии базы.