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

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

Особенность работы со справочниками в 1С заключается в их иерархической структуре и множестве реквизитов — как стандартных (наименование, код, родитель), так и пользовательских (цена, артикул, дата создания). Мы разберём, как получить значение любого реквизита — будь то системное поле или кастомное дополнение — с учётом типичных ошибок и нюансов платформы. Для наглядности приведём примеры кода, скриншоты интерфейса и сравнительную таблицу методов по скорости выполнения.

1. Получение значения через интерфейс 1С (без программирования)

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

Алгоритм действий:

🔍 Откройте справочник через меню Справочники → [Название справочника] (например, Справочники → Номенклатура).
📄 Найдите нужную запись в списке (используйте поиск по Ctrl+F или фильтры).
🖱️ Дважды кликните по строке, чтобы открыть карточку элемента.
📋 Выделите мышью значение нужного реквизита (например, поле "Артикул") и скопируйте его через Ctrl+C.

Этот способ удобен для разовых операций, но имеет ограничения:

❌ Невозможно автоматизировать (придётся повторять вручную для каждой записи).
❌ Не подходит для массового извлечения данных (например, для выгрузки в Excel).
❌ Риск ошибки при копировании (особенно если реквизитов много).

💡

Если вам нужно скопировать данные из нескольких справочников одновременно, используйте отчёт "Универсальный" (раздел Отчёты). Он позволяет выгрузить таблицу с любыми реквизитами в Excel за 2 клика.

2. Использование конструктора запросов (для пользователей)

Конструктор запросов в 1С — это полуавтоматический инструмент, который позволяет получить данные из справочников без написания кода. Он доступен пользователям с правами на создание отчётов и подходит для формирования выборок по нескольким реквизитам.

Пошаговая инструкция:

Перейдите в раздел Отчёты → Конструктор запросов (в некоторых конфигурациях путь может отличаться: Сервис → Конструктор запросов).
В открывшемся окне нажмите Добавить таблицу и выберите нужный справочник (например, Справочник.Контрагенты).
В списке доступных полей отметьте реквизиты, значения которых нужно получить (например, Наименование, ИНН, Код).
Нажмите Выполнить — система сформирует таблицу с данными.
Для выгрузки в Excel нажмите Ещё → Выгрузить в Excel.

Преимущества метода:

✅ Не требует знания языка 1С.
✅ Позволяет фильтровать данные (например, выбрать только активных контрагентов).
✅ Можно сохранять шаблоны запросов для повторного использования.

Выберите нужный справочник|Проверьте права доступа (требуется роль "Пользователь с правами на отчёты")|Определите список реквизитов для выборки|Настройте фильтры (если нужны не все записи)

-->

Ограничение: конструктор запросов не умеет работать с динамическими реквизитами (например, рассчитываемыми полями) и не всегда корректно отображает пользовательские реквизиты, добавленные в конфигураторе.

3. Программное получение значения (встроенный язык 1С)

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

3.1. Прямой доступ к объекту справочника

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

// Получаем ссылку на элемент справочника "Номенклатура" по коду СсылкаНаНоменклатуру = Справочники.Номенклатура.НайтиПоКоду("00000001"); // Получаем значение реквизита "Артикул" Артикул = СсылкаНаНоменклатуру.Артикул; // Выводим результат в сообщение

Сообщить("Артикул: " + Артикул);

Важные нюансы:

🔹 Метод НайтиПоКоду() ищет точное совпадение по коду. Если элемент не найден, вернёт Неопределён.
🔹 Для поиска по наименованию используйте НайтиПоНаименованию().
🔹 Если реквизит не существует, возникнет ошибка "Недопустимое значение свойства объекта".

3.2. Использование менеджера значения

Менеджер значения позволяет получить значение реквизита по его имени в виде строки. Это полезно, если имя реквизита формируется динамически. Пример:

СсылкаНаКонтрагента = Справочники.Контрагенты.НайтиПоНаименованию("ООО Ромашка");

// Получаем значение реквизита "ИНН" через менеджер значения
ИНН = СсылкаНаКонтрагента.Получить("ИНН");

// Альтернативный синтаксис (если реквизит может быть не заполнен)
Если Не ЗначениеЗаполнено(СсылкаНаКонтрагента.ИНН) Тогда
Сообщить("ИНН не указан!");
КонецЕсли;

Чем опасен метод Получить()

Метод Получить() не проверяет существование реквизита. Если вы ошибётесь в имени (например, напишете Получить("Инн") вместо "ИНН"), программа не выдаст ошибку, но вернёт Неопределён. Это может привести к скрытым багам в логике.

3.3. Запрос к базе данных

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

Запрос = Новый Запрос;
Запрос.Текст =
"ВЫБРАТЬ
|   Номенклатура.Ссылка КАК Ссылка,
|   Номенклатура.Наименование КАК Наименование,
|   Номенклатура.Код КАК Код
|ИЗ
|   Справочник.Номенклатура КАК Номенклатура";

Результат = Запрос.Выполнить();
Выборка = Результат.Выбрать();

Пока Выборка.Следующий() Цикл
Сообщить(Выборка.Код + " | " + Выборка.Наименование);
КонецЦикла;

Преимущества запросов:

⚡ Высокая скорость работы (оптимизирован для больших объёмов данных).
🔧 Гибкая фильтрация (можно использовать ГДЕ, УПОРЯДОЧИТЬ ПО).
📊 Возможность объединения данных из нескольких справочников.

Прямой доступ к объекту|Менеджер значения (Получить())|Запросы к базе данных|Не использую программирование-->

4. Работа с динамическими реквизитами

Динамические реквизиты — это пользовательские поля, которые добавляются к справочнику без изменения конфигурации (через механизм ДополнительныеРеквизитыИСведения). Их значения хранятся отдельно от основных реквизитов, поэтому для их извлечения требуются специальные методы.

Пример получения значения динамического реквизита "Цвет" для элемента справочника Номенклатура:

СсылкаНаНоменклатуру = Справочники.Номенклатура.НайтиПоКоду("00000002"); // Получаем коллекцию дополнительных реквизитов ДопРеквизиты = СсылкаНаНоменклатуру.ДополнительныеРеквизиты; // Ищем реквизит по имени и получаем его значение Цвет = ДопРеквизиты.Найти("Цвет").Значение;

Сообщить("Цвет номенклатуры: " + Цвет);

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

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

⚠️ Внимание: Если динамический реквизит не найден, метод Найти() вернёт Неопределён, что может привести к ошибке при попытке обращения к свойству .Значение. Всегда проверяйте результат:

ДопРеквизит = ДопРеквизиты.Найти("Цвет");
Если ДопРеквизит = Неопределён Тогда
Сообщить("Реквизит 'Цвет' не найден!");
Иначе
Сообщить("Значение: " + ДопРеквизит.Значение);
КонецЕсли;

5. Получение значений через OData (для интеграций)

Если вам нужно извлечь данные из 1С для внешней системы (например, сайта или мобильного приложения), удобно использовать протокол OData. Он позволяет получать значения реквизитов справочников по HTTP-запросам в формате JSON.

Пример запроса к OData-сервису 1С для получения наименования и кода номенклатуры:

GET /odata/standard.odata/Catalog_Номенклатура? $select=Ref_Key,Description,Code &$top=10 HTTP/1.1 Host: ваш_сервер_1с:8080

Authorization: Basic ваш_логин_пароль

Ответ сервера будет в формате JSON:

{
"value": [
{
"Ref_Key": "a1b2c3d4-5678-90ef-ghij-klmnopqrstuv",
"Description": "Стул офисный 'Эргономика'",
"Code": "00000001"
},
{
"Ref_Key": "b2c3d4e5-6789-01fg-hijk-lmnopqrstuvw",
"Description": "Стол письменный 'Классик'",
"Code": "00000002"
}
]
}

Преимущества OData:

🌐 Кроссплатформенность (работает с любыми системами, поддерживающими HTTP).
🔒 Безопасность (можно настроить авторизацию и ограничить доступ).
📊 Гибкая фильтрация (поддерживаются операторы $filter, $orderby).

⚠️ Внимание: Для использования OData необходимо:

Настроить публикацию OData-сервиса в 1С (раздел Администрирование → Публикация на веб-сервере).
Убедиться, что справочник включён в список опубликованных объектов.
Настроить права доступа для пользователя, от имени которого будут выполняться запросы.

💡

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

6. Типичные ошибки и как их избежать

При работе с реквизитами справочников даже опытные разработчики сталкиваются с типичными ошибками. Разберём самые распространённые из них и способы их решения.

6.1. Ошибка "Недопустимое значение свойства объекта"

Эта ошибка возникает, когда вы пытаетесь получить значение несуществующего реквизита. Например:

СсылкаНаКонтрагента = Справочники.Контрагенты.НайтиПоНаименованию("ООО Весна"); // Ошибочно: реквизита "ОГРНИП" не существует (правильно — "ОГРН")

ОГРН = СсылкаНаКонтрагента.ОГРНИП; // ← здесь будет ошибка

Решение: всегда проверяйте имена реквизитов в конфигураторе (раздел Объекты → [Справочник] → Реквизиты).

6.2. Пустые значения и `Неопределён`

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

ИНН = СсылкаНаКонтрагента.ИНН;
Если ИНН = Неопределён Или НЕ ЗначениеЗаполнено(ИНН) Тогда
ИНН = ""; // Подставляем пустую строку вместо Неопределён
КонецЕсли;

6.3. Проблемы с кодировкой при выгрузке

При выгрузке значений реквизитов в Excel или текстовые файлы могут возникать проблемы с кодировкой (например, вместо "Привет" отображается "ÐÐ¸Ð²ÐµÑ"). Это связано с несовпадением кодировок 1С (UTF-8) и целевого файла (например, Windows-1251).

Решение: явно указывайте кодировку при сохранении файла:

Текст = Новый ЗаписьТекста;
Текст.Открыть("C:\export\data.txt", КодировкаТекста.UTF8);
Текст.Записать(СсылкаНаНоменклатуру.Наименование);
Текст.Закрыть();

6.4. Зависание при массовой выборке

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

Решение: используйте запросы или массовое чтение:

// Плохо (медленно для больших справочников)
Выборка = Справочники.Номенклатура.Выбрать();
Пока Выборка.Следующий() Цикл
Наименование = Выборка.Наименование; // Отдельный запрос к базе!
КонецЦикла;

// Хорошо (оптимизированный запрос)
Запрос = Новый Запрос("ВЫБРАТЬ Наименование ИЗ Справочник.Номенклатура");
Результат = Запрос.Выполнить();

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

Каждое обращение к реквизиту через точку (Выборка.Наименование) выполняет отдельный SQL-запрос к базе данных. При 10 000 записях это 10 000 запросов! Запросы группируют данные и выполняются за 1 обращение к базе.

7. Оптимизация производительности

При работе с большими справочниками (десятки тысяч записей) скорость извлечения данных становится критичной. Вот ключевые приёмы оптимизации:

7.1. Используйте запросы вместо циклов

Как показано в предыдущем разделе, запросы в 1С выполняются на уровне СУБД и работают на порядки быстрее, чем поэлементный обход справочника.

7.2. Кэшируйте часто используемые данные

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

КэшНаименований = Новый Соответствие;

// Заполняем кэш один раз
Выборка = Справочники.Номенклатура.Выбрать();
Пока Выборка.Следующий() Цикл
КэшНаименований.Вставить(Выборка.Ссылка, Выборка.Наименование);
КонецЦикла;

// Далее используем кэш (быстро!)
Наименование = КэшНаименований[СсылкаНаНоменклатуру];

7.3. Ограничивайте выборку

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

Запрос.Текст =
"ВЫБРАТЬ
|   Номенклатура.Ссылка,
|   Номенклатура.Наименование
|ИЗ
|   Справочник.Номенклатура КАК Номенклатура
|ГДЕ
|   Номенклатура.ПометкаУдаления = ЛОЖЬ";

7.4. Избегайте вложенных циклов

Конструкции вида "цикл в цикле" (например, обход справочника Номенклатура внутри цикла по Документ.РеализацияТоваров) ведут к квадратичному росту времени выполнения. Решение:

📌 Предварительно загрузите все нужные данные в таблицу значений.
📌 Используйте соединения в запросах (оператор ЛЕВОЕ СОЕДИНЕНИЕ).

Пример оптимизированного запроса с соединением:

| ПО Реализация.Номенклатура = Номенклатура.Ссылка";

8. Практические примеры для разных справочников

Разберём конкретные примеры получения реквизитов из популярных справочников 1С.

8.1. Справочник "Контрагенты"

Задача: получить ИНН и КПП контрагента для печатной формы договора.

СсылкаНаКонтрагента = Справочники.Контрагенты.НайтиПоНаименованию("ООО Альфа");

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

// Формируем строку для договора
ТекстДоговора = СтрШаблон("Договор №%1 от %2 г.
Контрагент: %3 (ИНН %4, КПП %5)",
НомерДоговора, ТекущаяДата(), СсылкаНаКонтрагента.Наименование, ИНН, КПП);

8.2. Справочник "Номенклатура"

Задача: выгрузить в Excel список номенклатуры с полями Код, Наименование, Артикул и ЕдиницаИзмерения.

// Создаём таблицу значений для выгрузки
Таблица = Новый ТаблицаЗначений;
Таблица.Колонки.Добавить("Код");
Таблица.Колонки.Добавить("Наименование");
Таблица.Колонки.Добавить("Артикул");
Таблица.Колонки.Добавить("ЕдиницаИзмерения");

// Заполняем данные запросом
Запрос = Новый Запрос;
Запрос.Текст =
"ВЫБРАТЬ
|   Номенклатура.Код КАК Код,
|   Номенклатура.Наименование КАК Наименование,
|   Номенклатура.Артикул КАК Артикул,
|   Номенклатура.ЕдиницаИзмерения.Наименование КАК ЕдиницаИзмерения
|ИЗ
|   Справочник.Номенклатура КАК Номенклатура";

Результат = Запрос.Выполнить();
Выборка = Результат.Выбрать();

Пока Выборка.Следующий() Цикл
НоваяСтрока = Таблица.Добавить();
НоваяСтрока.Код = Выборка.Код;
НоваяСтрока.Наименование = Выборка.Наименование;
НоваяСтрока.Артикул = Выборка.Артикул;
НоваяСтрока.ЕдиницаИзмерения = Выборка.ЕдиницаИзмерения;
КонецЦикла;

// Выгружаем в Excel
Таблица.Записать("C:\Export\Номенклатура.xlsx", ТипФайлаExcel.XLSX);

8.3. Справочник "Сотрудники"

Задача: получить табельный номер и должность сотрудника для расчётного листка.

СсылкаНаСотрудника = Справочники.Сотрудники.НайтиПоНаименованию("Иванов И.И."); // Получаем реквизиты ТабельныйНомер = СсылкаНаСотрудника.ТабельныйНомер; Должность = СсылкаНаСотрудника.Должность.Наименование; // Формируем строку для расчётного листка Текст = СтрШаблон("Сотрудник: %1 Табельный номер: %2 Должность: %3",

СсылкаНаСотрудника.Наименование, ТабельныйНомер, Должность);

💡

Для справочников с иерархией (например, "Номенклатура" с группами) используйте реквизит ЭтотОбъект.Родитель, чтобы определить принадлежность элемента к группе.

FAQ: Частые вопросы по работе с реквизитами справочников

Как получить значение реквизита, если я не знаю его точного имени?

Используйте метод Метаданные(), чтобы получить список всех реквизитов справочника:

Метаданные = Справочники.Номенклатура.Метаданные();
Для Каждого Реквизит Из Метаданные.Реквизиты Цикл
Сообщить(Реквизит.Имя);
КонецЦикла;

Для динамических реквизитов используйте:

ДопРеквизиты = Справочники.Номенклатура.ДополнительныеРеквизиты; Для Каждого Реквизит Из ДопРеквизиты Цикл Сообщить(Реквизит.Имя);

КонецЦикла;

Можно ли получить значение реквизита из удалённой записи справочника?

Да, но для этого нужно временно снять пометку удаления или использовать специальный запрос с флагом ПометкаУдаления = ИСТИНА:

Запрос.Текст =
"ВЫБРАТЬ
|   Номенклатура.Наименование
|ИЗ
|   Справочник.Номенклатура КАК Номенклатура
|ГДЕ
|   Номенклатура.ПометкаУдаления = ИСТИНА";

⚠️ Внимание: Работа с удалёнными данными может нарушить логику программы. Используйте этот метод только для служебных задач (например, восстановления данных).

Как получить значение реквизита из справочника в отчёте или печатной форме?

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

&НаКлиенте
Процедура ПечатьДоговора(Команда)
Данные = Новый Структура("Контрагент", Объект.Контрагент);
ПечатнаяФорма = ПолучатьПечатнуюФорму("Договор", Данные);
ПечатнаяФорма.Показать();
КонецПроцедуры

// В шаблоне печатной формы (например, Word):
«Контрагент: [Контрагент.Наименование], ИНН [Контрагент.ИНН]»

Если реквизит не отображается, проверьте:

Права доступа к справочнику.
Наличие реквизита в метаданных.
Корректность имени реквизита в шаблоне.

Почему при получении значения реквизита возвращается не то, что отображается в интерфейсе?

Это может происходить по нескольким причинам:

Форматирование: В интерфейсе значение может отображаться с округлением (например, цена 100.500 отображается как 100.50), а программно возвращается полное значение.
Вычисляемые реквизиты: Некоторые реквизи

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