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

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

Представление объекта в 1С: что это и как работает

Что такое представление объекта в 1С, как платформа формирует его автоматически и как изменить представление через код, синоним и обработчики.

Когда вы видите в списке документов строку «Реализация товаров 0000-000123 от 15.03.2026», а в журнале справочника — «ООО Вектор», вы смотрите на представление объекта. Это текстовое отображение сущности базы данных, которое платформа 1С формирует автоматически, чтобы пользователь мог опознать запись, не открывая её карточку. Представление встречается везде: в списках, полях ввода, ссылках в документах, отчётах, на печатных формах.

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

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

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

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

Типовые места, где выводится представление:

  • динамические списки документов и справочников;
  • поля ввода со ссылочным типом (например, поле «Контрагент» в документе);
  • колонки табличных частей со ссылками;
  • отчёты на СКД и печатные формы;
  • заголовки форм объектов.

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

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

Правила построения представления зависят от типа объекта метаданных. Для документов строка собирается из синонима вида документа, номера и даты: «Поступление товаров и услуг 0000-000045 от 12.01.2026». Для справочников — из кода и наименования, причём состав зависит от настроек длины и признака «Автонумерация».

На состав представления справочника влияют свойства в конфигураторе: «Основное представление» (в виде кода или в виде наименования) определяет, что выводится в полях ввода. Если выбрано «В виде наименования», пользователь в поле контрагента увидит «ООО Вектор», если «В виде кода» — «00-000123».

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

ДокументСиноним + номер + дата

Например: «Заказ клиента 0000-000012 от 03.02.2026»

СправочникКод и/или наименование

Зависит от свойства «Основное представление»

ПеречислениеСиноним значения

Меняется только через конфигуратор

Запись регистраПредставления ключевых полей

Обычно выводится как комбинация измерений

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

Во встроенном языке представление ссылки получают через функцию Строка(Ссылка) или через свойство Представление у объекта. Например: Текст = Строка(ДокументСсылка); вернёт строку вида «Реализация товаров и услуг 0000-000077 от 20.03.2026».

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

Процедура ОбработкаПолученияПредставления(Данные, Представление, СтандартнаяОбработка)

СтандартнаяОбработка = Ложь;

Представление = Строка(Данные.Номер) + " от " + Формат(Данные.Дата, "ДЛФ=D");

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

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

Синонимы и представление типа объекта

Отдельная тема — представление самого вида объекта, а не конкретной записи. За него отвечает свойство «Синоним» в конфигураторе. Именно синоним «Реализация товаров и услуг» появляется в начале строки представления документа, в меню разделов и в заголовках списков.

Есть также свойство «Представление объекта» и «Представление списка» у справочников и документов. «Представление объекта» — это название единичной записи (например, «Номенклатура»), «Представление списка» — название списка («Номенклатура» или «Товары»). Если эти свойства не заполнены, платформа использует синоним.

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

Типичные задачи и способы их решения

Чаще всего на практике встречаются четыре сценария: изменить то, что видно в поле ввода; изменить строку в списке; вывести нестандартное представление в отчёте; получить представление программно для сообщения пользователю или записи в журнал.

Маршрут решения

Как выбрать способ

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

В языке запросов есть функция ПРЕДСТАВЛЕНИЕ(Поле), которая возвращает представление ссылки прямо в запросе. Это удобно для отчётов, но помните: функция не учитывает переопределённое представление из обработчика менеджера в ряде случаев и может влиять на производительность при больших выборках.

Как проверить результат и какие ошибки встречаются

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

Контрольные точки

Как проверить результат

Список объектов
Норма

Строки читаемы, формат единый

Тревожный признак

Часть записей в старом формате или пустые строки

Поле ввода со ссылкой
Норма

Отображается ожидаемый реквизит

Тревожный признак

Показывается код вместо наименования или наоборот

Отчёт с функцией ПРЕДСТАВЛЕНИЕ
Норма

Значения совпадают со списком

Тревожный признак

Отличаются от списка — возможно, обработчик не учитывается

Скорость открытия списка
Норма

Список открывается без задержек

Тревожный признак

Заметное «подвисание» — тяжёлый код в обработчике

Типичные ошибки
01
Запрос к базе внутри ОбработкаПолученияПредставления — приводит к тормозам каждого списка
02
Попытка «сохранить» представление в отдельный реквизит — данные дублируются и расходятся при изменении
03
Изменение синонима в типовой конфигурации без снятия с поддержки по правилам — риск потери изменений при обновлении
04
Ожидание, что ПРЕДСТАВЛЕНИЕ() в запросе применит обработчик менеджера — логика может не совпасть с интерфейсом

Ограничения и частые вопросы

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

Итог

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

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

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

Синоним — это название вида метаданных (например, «Документ "Заказ клиента"»), а представление — строка конкретной записи («Заказ клиента 0000-000005 от 10.02.2026»). Синоним задаётся в конфигураторе, представление формируется автоматически для каждой ссылки.

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

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

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

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

Влияет ли переопределение представления на поиск?

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

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

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

Опасно ли менять представление в рабочей базе?

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