Как установить заголовок программы в 1С

Заголовок программы 1С — это текст в шапке главного окна приложения, который видят пользователи при работе с информационной базой. По умолчанию там отображается синоним конфигурации, но его можно заменить на понятное название компании, указать текущую базу или добавить служебную пометку «тестовая база», чтобы пользователи не путали рабочий и учебный контур.

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

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

Что именно меняется: заголовок окна, синоним конфигурации и представление

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

Это различие важно на практике: если изменить только синоним, он отразится и в других местах интерфейса — например, в заголовках некоторых форм и в окне «О программе». Если нужно поменять исключительно шапку главного окна, правильнее использовать представление приложения или программный метод.

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

Способ 1: установить заголовок через конфигуратор

Самый простой и надёжный вариант — задать представление приложения в свойствах конфигурации. Такой заголовок хранится в самой конфигурации, не требует кода и работает сразу после обновления базы.

Откройте конфигуратор, выберите в главном меню «Конфигурация → Открыть конфигурацию». В дереве объектов дважды щёлкните по корневому элементу — он называется так же, как конфигурация. Откроется палитра свойств. Найдите поле «Представление прилojения» (Presentation) и введите нужный текст, например «Управление торговлей — ООО Ромашка».

Сохраните конфигурацию (F7 или «Конфигурация → Сохранить конфигурацию»), затем обновите конфигурацию базы данных (F5 в режиме отладки или «Конфигурация → Обновить конфигурацию базы данных»). После перезапуска клиентского приложения новый заголовок появится в шапке окна.

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

Если поле «Представление приложения» оставить пустым, платформа использует синоним конфигурации. Это поведение по умолчанию, и менять его нужно осознанно: пустое поле не означает пустой заголовок.

Способ 2: установить заголовок программно

Когда текст заголовка зависит от данных — имени базы, пользователя, даты — используется метод встроенного языка УстановитьЗаголовокПриложения() (в тонком клиенте и веб-клиенте) или устаревший УстановитьЗаголовокСистемы() для толстого клиента. В современных конфигурациях на управляемых формах применяйте первый вариант.

Типовое место вызова — обработчик ПриНачалеРаботыСистемы в модуле управляемого приложения (или модуле обычного приложения). Заголовок устанавливается один раз при старте сеанса.

Процедура ПриНачалеРаботыСистемы()
	СтрокаСоединения = СтрокаСоединенияИнформационнойБазы();
	Если СтрНайти(СтрокаСоединения, "Test") > 0 Тогда
		УстановитьЗаголовокПриложения("ТЕСТОВАЯ БАЗА — Управление торговлей");
	Иначе
		УстановитьЗаголовокПриложения("Управление торговлей — " + ИмяПользователя());
	КонецЕсли;
КонецПроцедуры

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

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

Где размещать код в разных режимах

В конфигурации с управляемым приложением — модуль управляемого приложения, обработчик ПриНачалеРаботыСистемы. В обычном приложении (толстый клиент) — модуль обычного приложения, тот же обработчик, но доступен и метод УстановитьЗаголовокСистемы. Если конфигурация поддерживает оба режима, код придётся продублировать или вынести в общий серверный модуль с вызовом из обоих обработчиков.

Как выбрать между конфигуратором и кодом

Практическое правило простое: статичное название — в конфигураторе, всё что вычисляется — в коде. Комбинировать способы можно: базовое представление задать в свойствах, а в тестовой базе переопределять его программно с пометкой «ТЕСТ».

Проверка результата и частые ошибки

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

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

Ограничения и частные сценарии

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

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

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

FAQ