Установить представление в 1С: что это значит и как это сделать

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

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

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

Что такое представление в 1С и где оно используется

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

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

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

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

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

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

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

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

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

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

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

Второй вариант — программный, через обработчик события ОбработкаПолученияПредставления в модуле менеджера объекта. В нём можно собрать любую строку: например, добавить к наименованию контрагента его ИНН или к документу — сумму. Внутри обработчика нужно установить параметр СтандартнаяОбработка = Ложь и заполнить параметр Представление своим текстом.

Процедура ОбработкаПолученияПредставления(Данные, Представление, СтандартнаяОбработка)
	СтандартнаяОбработка = Ложь;
	Представление = Данные.Наименование + " (ИНН " + Данные.ИНН + ")";
КонецПроцедуры

У программного способа есть цена: обработчик вызывается при каждом отображении объекта, и если внутри выполнять запросы к базе, список из тысячи элементов будет открываться заметно медленнее. Используйте только те данные, что уже есть в параметре «Данные», либо кэшируйте вычисления.

Способ 3. Задать представление значения через форматную строку

Третья задача — изменить, как выводится конкретное значение: дата, число, булево. Для этого используется функция Формат() или свойство «Формат» у полей формы и ячеек макета. Например, форматная строка ДЛФ=D выводит дату полностью, ЧН=0 заменяет нулевое число на «0», БЛ=Нет; БИ=Да задаёт представление булева.

Форматную строку можно установить: в палитре свойств элемента формы (поле «Формат»), в ячейке табличного документа при выводе печатной формы, в запросе через конструкцию ПРЕДСТАВЛЕНИЕ() для ссылок, либо программно через функцию Формат(Значение, ФорматнаяСтрока).

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

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

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

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

Для форматных строк проверьте граничные значения: пустую дату, ноль, NULL в запросе. Именно на пустых значениях чаще всего вылезают неожиданные строки вроде «01.01.0001» — их нужно отдельно обрабатывать через ДП= или ЧН= в форматной строке.

Ограничения и типичные ошибки

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

Обработчик ОбработкаПолученияПредставления не сработает, если разместить его не в модуле менеджера объекта, а, например, в модуле объекта или формы. Это самая частая причина «не работает представление». Также учтите: в тонком и веб-клиенте обработчик выполняется на сервере, поэтому обращение к клиентским функциям в нём невозможно.

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

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