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

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

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

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

Через точку от ссылки — самый простой способ

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

Контрагент = Документ.Контрагент; // СправочникСсылка.Контрагенты
ИНН = Контрагент.ИНН;
Наименование = Контрагент.Наименование;

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

Ещё одно ограничение: если ссылка «битая» (элемент удалён, а ссылка осталась в документе), обращение к реквизиту вернёт значение по умолчанию или вызовет ошибку в зависимости от контекста. Поэтому перед чтением полезно проверять ссылку на пустоту и существование.

Получение объекта и изменение реквизита

Метод ПолучитьОбъект() превращает ссылку в полноценный объект СправочникОбъект, который можно не только читать, но и модифицировать. Это единственный корректный путь, когда задача — не просто узнать значение, а записать новое.

ЭлементОбъект = Ссылка.ПолучитьОбъект();
ЭлементОбъект.Комментарий = "Обновлено обработкой";
ЭлементОбъект.Записать();

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

Для массовых изменений оборачивайте запись в транзакцию (НачатьТранзакцию / ЗафиксироватьТранзакцию) и всегда проверяйте результат ПолучитьОбъект() на Неопределено перед обращением к свойствам.

Получение реквизита через запрос

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

Запрос = Новый Запрос;
Запрос.Текст =
"ВЫБРАТЬ
|	Номенклатура.Ссылка КАК Ссылка,
|	Номенклатура.Артикул КАК Артикул,
|	Номенклатура.ЕдиницаИзмерения КАК Единица
|ИЗ
|	Справочник.Номенклатура КАК Номенклатура
|ГДЕ
|	Номенклатура.Код = &Код";
Запрос.УстановитьПараметр("Код", "00-000123");
Выборка = Запрос.Выполнить().Выбрать();
Если Выборка.Следующий() Тогда
Артикул = Выборка.Артикул;
КонецЕсли;

Обратите внимание на проверку Выборка.Следующий(): если элемент с указанным кодом не найден, выборка будет пустой, и обращение к полям без проверки даст ошибку или пустое значение в зависимости от способа получения данных. Это стандартный приём защитного программирования в 1С.

Для поиска самой ссылки по реквизиту можно также использовать метод НайтиПоРеквизиту, НайтиПоКоду или НайтиПоНаименованию менеджера справочника, а уже от найденной ссылки читать остальные поля. Это удобно, когда нужен один элемент.

Ссылка = Справочники.Контрагенты.НайтиПоРеквизиту("ИНН", "7707083893");
Если Не Ссылка.Пустая() Тогда
	Наименование = Ссылка.Наименование;
КонецЕсли;

Какой способ выбрать в разных ситуациях

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

Отдельно стоит упомянуть работу в управляемых формах. В клиентском коде формы (директива &НаКлиенте) прямое обращение к базе через запросы и менеджеры справочников недоступно — нужно вызывать серверную процедуру. Частый приём — функция на сервере, принимающая ссылку и возвращающая структуру с нужными реквизитами.

Особые случаи: предопределённые элементы и дополнительные реквизиты

Предопределённые элементы

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

ВалютаРуб = Справочники.Валюты.Рубли;
КодВалюты = ВалютаРуб.Код;

Дополнительные реквизиты и сведения

В типовых конфигурациях многие пользовательские поля хранятся не в реквизитах справочника, а в механизме дополнительных реквизитов и сведений (подсистема «Свойства» БСП). Через точку такие значения не получить — нужно обращаться к табличной части «ДополнительныеРеквизиты» объекта или к регистру сведений «ДополнительныеСведения», а в типовых — использовать функции модуля УправлениеСвойствами.

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

Проверка результата и отладка

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

Для проверки существования элемента по ссылке используйте сравнение с пустой ссылкой: Ссылка.Пустая() или Ссылка = Справочники.Номенклатура.ПустаяСсылка(). Для проверки «битости» ссылки в типовых конфигурациях есть функция ОбщегоНазначения.СсылкаСуществует.

При работе в пользовательском режиме без программирования значение реквизита можно посмотреть прямо в форме элемента справочника, а также вывести нужную колонку в список справочника через настройку списка (Ещё → Изменить форму или настройка списка в типовых конфигурациях).

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