Разработка и Конфигурация · 9 мин
Основное представление справочника в 1С: что это и как его настроить
Основное представление справочника в 1С — что это, как выбрать: код, наименование или произвольное. Настройка в конфигураторе, влияние на поиск и подбор, типичные ошибки.
Основное представление справочника в 1С — это свойство объекта конфигурации, которое определяет, как именно элемент справочника отображается пользователю в полях ввода, списках выбора и ссылках в документах. Когда бухгалтер видит в поле «Контрагент» строку «ООО «Вектор»», а программист — «000000123», разница именно в этом свойстве.
Настройка задаётся в конфигураторе на закладке «Представление» (в ранних версиях платформы — «Поля») палитры свойств справочника. От неё зависит не только внешний вид ссылок, но и поведение быстрого поиска при вводе строки в поле ввода: платформа ищет по тому реквизиту, который выбран основным представлением.
Выбор влияет на удобство всей учётной системы. Неправильно подобранное представление приводит к тому, что пользователи не могут найти нужный элемент по названию, вынуждены запоминать коды или путают одноимённые элементы. Разберём, какие варианты доступны, как их настроить и чем они отличаются.
Что такое основное представление и где оно задаётся
У каждого справочника в 1С есть стандартные реквизиты «Код» и «Наименование». Основное представление указывает платформе, какой из них (или какая их комбинация) будет служить «визитной карточкой» элемента: именно этот текст появляется в ячейках табличных частей, в полях ссылочного типа и в заголовках форм элементов.
Найти настройку можно в конфигураторе: Справочники → нужный справочник → правой кнопкой «Свойства» → закладка «Представление». Там же находятся связанные свойства: длина кода, длина наименования, основное представление и флажок автонумерации.
Какие варианты представления доступны
Платформа предлагает три стандартных варианта выбора. Каждый подходит для своего типа данных, и выбор стоит делать исходя из того, как пользователи идентифицируют элементы в повседневной работе.
| Вариант | Что видит пользователь | Когда подходит |
|---|---|---|
| В виде кода | «000000123» | Технические справочники, где код — осмысленный идентификатор (артикулы, штрихкоды, счета) |
| В виде наименования | «ООО «Вектор»» | Большинство прикладных справочников: контрагенты, номенклатура, сотрудники |
| В виде кода и наименования | «000000123 ООО «Вектор»» | Когда нужна однозначная идентификация при повторяющихся наименованиях |
В типовых конфигурациях для большинства справочников выбран вариант «В виде наименования» — это наиболее читаемый формат. Вариант «в виде кода» встречается, например, у плана счетов, где номер счёта («10.01», «60.01») и есть привычное обозначение для бухгалтера.
Сравнение вариантов
Максимально понятно пользователю, но при одинаковых названиях элементы неотличимы без открытия карточки
Устраняет путаницу при дубликатах, но поля ввода становятся шире и списки громоздче
Компактно и однозначно, но требует от пользователей знания системы кодировки
Как настроить основное представление в конфигураторе
Изменение выполняется в конфигураторе и требует обновления конфигурации базы данных. Порядок действий прост, но его стоит выполнять на копии базы, если конфигурация доработанная.
- 1Откройте конфигуратор и снимите конфигурацию с поддержки при необходимости (или убедитесь, что объект доступен для изменения)
- 2Найдите нужный справочник в дереве конфигурации и откройте его свойства
- 3Перейдите на закладку «Представление»
- 4В поле «Основное представление» выберите нужный вариант: код, наименование или код и наименование
- 5Обновите конфигурацию базы данных (F7) и проверьте отображение в режиме предприятия
После обновления откройте любой документ, где используется этот справочник, и убедитесь, что ссылки отображаются в новом формате. Проверьте также ввод по строке: начните набирать наименование в поле ввода и посмотрите, находит ли платформа нужный элемент.
Как представление влияет на поиск и подбор
Основное представление напрямую определяет поведение функции «ввод по строке»: когда пользователь начинает печатать в поле ссылочного типа, платформа ищет совпадения по тому реквизиту, который назначен основным представлением. Если выбрано наименование — поиск идёт по наименованию, если код — по коду.
Это частая причина жалоб «не находит контрагента по названию»: у справочника основное представление установлено «в виде кода», и платформа ищет только среди кодов. Смена представления на «в виде наименования» или «код и наименование» решает проблему без доработки кода.
В управляемых формах поведение поиска дополнительно зависит от настроек динамического списка и свойства поля ввода «История выбора при вводе», но базовым остаётся именно основное представление объекта.
Программное получение представления и обработчики
В коде представление элемента можно получить простым преобразованием ссылки в строку — платформа вернёт значение согласно основному представлению. Для нестандартных сценариев в модуле менеджера справочника доступны обработчики получения представления и полей представления.
Процедура ОбработкаПолученияПредставления(Данные, Представление, СтандартнаяОбработка)
СтандартнаяОбработка = Ложь;
Представление = Данные.Наименование + " (" + Данные.Код + ")";
КонецПроцедурыЧерез обработчик ОбработкаПолученияПредставления можно вывести произвольную строку, например наименование с артикулом или городом контрагента. Дополнительно обработчик ОбработкаПолученияПолейПредставления определяет, какие поля платформа запрашивает из базы для формирования представления — это важно для производительности, чтобы не тянуть лишние данные.
Учтите: переопределённое представление применяется везде, где используется стандартный механизм, но не заменяет данные в уже сформированных печатных формах и отчётах, если там представление собиралось вручную запросом.
Типичные ошибки и ограничения
Ещё одно ограничение: основное представление — свойство всего справочника, а не отдельных групп или элементов. Нельзя настроить разное отображение для разных видов номенклатуры штатным свойством; для этого придётся использовать обработчик получения представления с проверкой реквизитов.
Как проверить результат
Показывается выбранный формат (наименование или код с наименованием)
Отображается пустая строка или старый формат — конфигурация не обновлена
При наборе текста выпадает список с подходящими элементами
Список пуст или ищется только по коду
Список открывается без задержек
После внедрения обработчика список «подвисает» — лишние поля в представлении
Часто задаваемые вопросы
Можно ли изменить основное представление без конфигуратора?
Штатно — нет, это свойство конфигурации. Альтернатива без изменения конфигурации — расширение, в котором для справочника переопределяются обработчики получения представления, либо настройка формы списка с выводом нужных колонок, что влияет только на конкретную форму.
Почему после смены представления в поле ввода показывается старое значение?
Проверьте, что конфигурация базы данных обновлена (в конфигураторе не должно быть восклицательного знака у корня дерева). Также очистите кэш метаданных клиента: перезапустите сеанс или удалите базу из списка и добавьте заново.
Влияет ли основное представление на обмен данными и синхронизацию?
Нет. Обмен данными оперирует уникальными идентификаторами и полями объекта, а не текстовым представлением. Представление — чисто интерфейсная настройка и не меняет структуру хранимых данных.
Как вывести в представлении справочника произвольный реквизит, например ИНН контрагента?
Используйте в модуле менеджера справочника обработчики ОбработкаПолученияПолейПредставления (укажите поля «Наименование» и «ИНН») и ОбработкаПолученияПредставления, где сформируйте строку вида Наименование + ", ИНН " + ИНН. Стандартное свойство «Основное представление» работает только с кодом и наименованием.
Что выбрать для справочника с повторяющимися наименованиями?
Вариант «В виде кода и наименования» — он сохраняет читаемость и позволяет различать одноимённые элементы по коду. Дополнительно стоит включить контроль уникальности наименований прикладным кодом, если дубликаты недопустимы по логике учёта.
Отличается ли настройка для планов счетов и планов видов характеристик?
Принцип тот же: у этих объектов есть аналогичное свойство основного представления с вариантами кода, наименования (или описания) и их комбинации. Для планов счетов традиционно выбирают представление в виде кода, чтобы в проводках отображались номера счетов.
Что важно запомнить
Основное представление справочника определяет, какой реквизит — код, наименование или их комбинацию — видит пользователь в ссылках и использует при поиске по строке. Настраивается в конфигураторе на закладке «Представление», а нестандартные варианты реализуются обработчиками получения представления в модуле менеджера. Для типовых конфигураций предпочтительны расширения вместо прямого изменения.