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

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

В этой статье разберем 5 основных методов — от ручного извлечения через формы до программного доступа через Запрос и REST API. Особое внимание уделим типичным ошибкам, которые приводят к пустым результатам или сбоям, а также нюансам работы с разными типами реквизитов (примитивные, ссылки, табличные части). Если вы только начинаете осваивать 1С, начните с первых двух разделов — там минимум кода. Опытным разработчикам будет полезен раздел про динамическое чтение реквизитов по имени.

⚠️ Внимание: Версии платформы 1С:Предприятие 8.3.20+ ввели изменения в работу с динамическими свойствами объектов. Если вы используете более ранние релизы, проверьте совместимость методов в документации.

Для практики подготовьте тестовую базу — лучше на последней версии платформы. Все примеры кода в статье работают в режиме 1С:Предприятие (не в конфигураторе!), если не указано иное.

1. Получение значения реквизита через точку (синтаксис доступа)

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

Примеры синтаксиса:

// Для справочника
Справочник.Номенклатура.Наименование

// Для документа
Документ.ПоступлениеТоваров.Контрагент

// Для регистра сведений
РегистрСведений.ЦеныНоменклатуры.Цена

Особенности метода:

• 🔹 Работает только для стандартных реквизитов (не динамических).
• 🔹 Если реквизит — ссылка на другой объект, вернется ссылка, а не его наименование. Чтобы получить текстовое представление, используйте метод .Представление().
• 🔹 Для табличных частей используйте конструкцию Объект.ТабличнаяЧасть[Индекс].Реквизит.

⚠️ Внимание: При обращении к несуществующему реквизиту платформа выбросит ошибку {ОбщийМодуль.МодульОбъекта.Модуль(12)}: Поле объекта не обнаружено (РеквизитНеСуществует). Всегда проверяйте наличие реквизита через Метаданные() в критичных сценариях.

2. Функция ЗначениеРеквизита() — когда точка не работает

Функция ЗначениеРеквизита() — универсальный инструмент для чтения реквизитов, когда:

• 📌 Нужно получить значение по имени реквизита (динамически).
• 📌 Реквизит скрыт или его имя содержит спецсимволы.
• 📌 Работаете с динамическими списками или формой, где прямая точка недоступна.

Синтаксис:

ЗначениеРеквизита(Объект, "ИмяРеквизита")

Примеры использования:

// Получение наименования контрагента из документа
НаименованиеКонтрагента = ЗначениеРеквизита(Документ.ПоступлениеТоваров, "Контрагент.Наименование");

// Динамическое чтение реквизита по имени из переменной
ИмяРеквизита = "ДатаДокумента";
Дата = ЗначениеРеквизита(Документ, ИмяРеквизита);

Ключевые отличия от точечного синтаксиса:

⚠️ Внимание: В версиях платформы 8.3.18–8.3.19 была ошибка с функцией ЗначениеРеквизита() для реквизитов типа ХранилищеЗначения. Если вы работаете с этими версиями, используйте обходной путь через временную переменную.

3. Извлечение реквизитов через запрос (язык запросов 1С)

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

• 📊 Отчетов и аналитики.
• 🔄 Массовой обработки данных.
• 🔗 Связанных данных из нескольких таблиц.

Базовый синтаксис:

ВЫБРАТЬ
Документ.ПоступлениеТоваров.Ссылка КАК Ссылка,
Документ.ПоступлениеТоваров.Дата КАК Дата,
Документ.ПоступлениеТоваров.Контрагент.Наименование КАК Контрагент
ИЗ
Документ.ПоступлениеТоваров КАК Документ
ГДЕ
Документ.Дата МЕЖДУ &НачалоПериода И &КонецПериода

Нюансы работы с запросами:

• 🔸 Для получения ссылочных реквизитов (например, контрагент) используйте точку: Контрагент.Наименование.
• 🔸 Чтобы избежать дублирования данных, применяйте РАЗЛИЧНЫЕ или ГРУППИРОВКА.
• 🔸 Для табличных частей используйте конструкцию Документ.ТабличнаяЧасть КАК ТабличнаяЧасть.

Пример с табличной частью:

ВЫБРАТЬ
Документ.ПоступлениеТоваров.Номер КАК НомерДокумента,
ТабличнаяЧастьТовары.Номенклатура.Наименование КАК Номенклатура,
ТабличнаяЧастьТовары.Количество КАК Количество
ИЗ
Документ.ПоступлениеТоваров КАК Документ
ЛЕВОЕ СОЕДИНЕНИЕ Документ.ПоступлениеТоваров.Товары КАК ТабличнаяЧастьТовары
ПО Документ.Ссылка = ТабличнаяЧастьТовары.Ссылка
ГДЕ
Документ.Дата = &ТекущаяДата

⚠️ Внимание: В запросах нельзя использовать реквизиты, которые не хранятся в базе данных (например, вычисляемые поля форм). Для таких случаев комбинируйте запрос с пост-обработкой результатов в коде.

Проверьте наличие индексов по полям в условии WHERE|Используйте псевдонимы (КАК) для удобства|Ограничьте выборку датами/периодами|Тестируйте запрос в конструкторе (F5)|Обрабатывайте результат через ОбъектРезультатаЗапроса-->

4. Работа с реквизитами через формы (интерактивный способ)

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

Шаги для извлечения значения:

1. Откройте объект (например, документ Поступление товаров) в режиме просмотра или редактирования.
2. Нажмите Alt+F9, чтобы открыть панель Все действия.
3. Выберите Все действия → Стандартные → Вывести список реквизитов (или аналогичный пункт для вашей версии).
4. В открывшемся окне найдите нужный реквизит и скопируйте его значение.

Для табличных частей:

• 📋 Выделите строку в таблице.
• 📋 Нажмите правую кнопку мыши и выберите Копировать (или Вывести список реквизитов, если доступно).

Ограничения метода:

• 🚫 Не работает для невидимых реквизитов (скрытых настройками формы).
• 🚫 Невозможно массово извлечь данные (только по одному объекту).
• 🚫 Не подходит для реквизитов, которые вычисляются динамически (например, Итог в документе).

⚠️ Внимание: В тонком клиенте и веб-клиенте некоторые пункты меню Все действия могут быть недоступны. В этом случае используйте Ctrl+Shift+F1 для вызова справки по текущему полю — там часто отображается его внутреннее имя.

5. Программное чтение реквизитов через API и внешние системы

Если вам нужно получить значения реквизитов из внешней системы (например, 1C:EDT, REST-сервис или Python-скрипт), используйте один из следующих методов:

а) OData (REST API)

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

GET /odata/standard.odata/Catalog_Номенклатура?$select=Ref_Key,Description&$top=10

Где:

• Ref_Key — уникальный идентификатор (ссылка).
• Description — наименование (аналог реквизита Наименование).

б) COM-соединение (для Windows)

Пример на VBScript для чтения реквизита документа:

Set V8 = CreateObject("V83.ComConnector")
Set Connection = V8.Connect("File=C:\Bases\Trade;Usr=Администратор")
Set Document = Connection.NewObject("Документ.ПоступлениеТоваров")
Document.НайтиПоНомеру("ПТ-000123")
MsgBox Document.Контрагент.Наименование

в) HTTP-сервисы (1C:Предприятие 8.3.15+)

Для интеграции с веб-приложениями настройте HTTP-сервис в конфигураторе и экспортируйте методы чтения реквизитов. Пример кода для сервиса:

Функция ПолучитьРеквизитДокумента(НомерДокумента, ИмяРеквизита)
Документ = Документы.ПоступлениеТоваров.НайтиПоНомеру(НомерДокумента);
Возврат Документ[ИмяРеквизита];
КонецФункции

⚠️ Внимание: При работе с REST API или HTTP-сервисами всегда настраивайте права доступа на уровне ролей. По умолчанию внешние соединения имеют минимальные права, что может блокировать чтение реквизитов.

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

Даже опытные разработчики сталкиваются с проблемами при чтении реквизитов. Вот TOP-3 ошибки, которые ведут к пустым результатам или сбоям:

Ошибка 1: П попытка чтения несуществующего реквизита

Симптомы: Ошибка Поле объекта не обнаружено (ИмяРеквизита).

Решение: Перед обращением проверяйте наличие реквизита:

Если Метаданные.Справочники.Номенклатура.Реквизиты.Найти("НесуществующийРеквизит") <> Неопределено Тогда
// Код чтения
КонецЕсли;

Ошибка 2: Пустое значение у ссылочного реквизита

Симптомы: Код Документ.Контрагент.Наименование выдает ошибку, если Контрагент не заполнен.

Решение: Используйте конструкцию ? Документ.Контрагент.Наименование : "" или проверяйте заполненность:

Если Не Документ.Контрагент.Пустая() Тогда
Сообщить(Документ.Контрагент.Наименование);
КонецЕсли;

Ошибка 3: Несовпадение типов данных

Симптомы: Ошибка приведения типов, например, при попытке записать строку в реквизит типа Число.

Решение: Явно преобразуйте типы:

Документ.СуммаДокумента = Число(ЗначениеРеквизита(Документ, "ИтогСумма"));

Дополнительные подводные камни:

⚠️ Внимание: В управляемых формах реквизиты могут иметь отличные от метаданных имена (например, Контрагент_Key вместо Контрагент). Всегда проверяйте реальные имена через Все действия → Стандартные → Вывести список реквизитов.

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

Значение = Объект["Реквизит с пробелом"];
// или для точечного синтаксиса (в новых версиях платформы)
Значение = Объект.["Реквизит.С.Точкой"];

ВЫБРАТЬ [Реквизит с пробелом]...

Ссылка = Справочники.Номенклатура.НайтиПоНаименованию("Товар 1");
Наименование = Ссылка.Наименование;

Ссылка = Документы.ПоступлениеТоваров.НайтиПоНомеру("ПТ-123");
Дата = Ссылка.Дата;

// Пример выгрузки справочника в Excel
Таблица = Новый ТаблицаЗначений;
Таблица.Колонки.Добавить("Наименование");
Таблица.Колонки.Добавить("Артикул");

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

Excel = Новый COMОбъект("Excel.Application");
Excel.Visible = Истина;
Книга = Excel.Workbooks.Add();
Лист = Книга.Worksheets(1);
Лист.Range("A1").Value = Таблица.Выгрузить();

// Получение документа по версии
ВерсияДокумента = Документы.ПоступлениеТоваров.ПолучитьВерсию(СсылкаНаДокумент, ДатаВерсии);
ОбъектВерсии = ВерсияДокумента.ПолучитьОбъект();
Значение = ОбъектВерсии.Реквизит;

ВерсияСправочника = Справочники.Номенклатура.ПолучитьВерсию(Ссылка, ДатаВерсии);
Значение = ВерсияСправочника.ПолучитьОбъект().Наименование;