Значение реквизита в 1С: что это и как работает в конфигураторе

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

Если вы когда-нибудь сталкивались с ошибками типа «Недопустимое значение реквизита» или пытались передать данные между объектами, то знаете: без чёткого представления о том, что такое значение реквизита, как оно хранится и как изменяется, решить проблему бывает крайне сложно. Эта статья поможет разложить всё по полочкам — от базовых определений до практических примеров с кодом.

1. Определение: что такое реквизит и его значение в 1С

В контексте 1С:Предприятие реквизит — это атрибут объекта конфигурации (справочника, документа, регистра и т.д.), который хранит определённые данные. А значение реквизита — это конкретное содержимое этого атрибута в текущий момент времени. Например:

📌 У справочника Номенклатура есть реквизит Наименование. Его значением может быть строка «Монитор Samsung 24\"».
📅 У документа ПоступлениеТоваров реквизит Дата хранит значение «15.05.2026».
💰 У регистра накопления ОстаткиТоваров реквизит Количество может иметь значение «10».

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

🔄 Меняется в процессе работы программы (например, при редактировании документа).
🔗 Связана с типом данных реквизита (строка, число, дата, ссылка на другой объект и т.д.).
🛠️ Может быть прочитано или изменено как вручную (через интерфейс), так и программно (через код на встроенном языке).

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

2. Типы значений реквизитов в 1С: классификация и примеры

Значения реквизитов в 1С строго типизированы. Это означает, что каждый реквизит при создании в конфигураторе получает определённый тип данных, который ограничивает возможные значения. Основные типы:

Тип данных	Пример значения	Где используется
`Строка`	`"Привет, мир!"`	Наименования, комментарии, адреса
`Число`	`100.50`	Цены, количества, проценты
`Дата`	`'2026-05-15'`	Даты документов, сроки действия
`Булево`	`Истина` / `Ложь`	Флаги, статус активности
`Ссылка`	`Справочник.Контрагенты.Иванов`	Связи между объектами (например, контрагент в документе)

Особняком стоят составные типы, такие как:

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

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

💡

Чтобы узнать тип значения реквизита программно, используйте функцию ТипЗнч(). Например:

ТипТекЗначения = ТипЗнч(Объект.Реквизит);

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

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

Прямое обращение через точку (самый простой способ):
```
Значение = Объект.Реквизит;
```
Работает для текущих объектов в форме или модуле.

Метод Получить() (для динамического доступа):
```
Значение = Объект.Получить("ИмяРеквизита");
```
Удобно, когда имя реквизита формируется программно.

Через коллекцию Реквизиты (для перебора):

Для Каждого Реквизит Из Объект.Реквизиты Цикл Сообщить(Реквизит.Имя + ": " + Реквизит.Значение);

КонецЦикла;

При работе с формами (например, в управляемом приложении) часто используют метод ЗначениеРеквизита():

Значение = ЭлементыФормы.ИмяПоля.Значение;

Это не то же самое, что пустая строка или ноль! Проверить это можно так:

Если Значение = Неопределено Тогда // Обработка отсутствия значения

КонецЕсли;

Что будет, если не проверить значение на Неопределено?

При попытке использовать Неопределено в арифметических операциях или конкатенации строк возникнет ошибка выполнения. Например, код Сумма = 100 + Неопределено; завершится с исключением.

4. Как изменить значение реквизита: правила и ограничения

Изменение значения реквизита — одна из самых частых операций в 1С, но и здесь есть нюансы:

🔧 Прямое присваивание (для простых типов):
```
Объект.Реквизит = НовоеЗначение;
```
Работает, если тип нового значения совпадает с типом реквизита.

🔄 Метод Установить() (для динамического изменения):
```
Объект.Установить("ИмяРеквизита", НовоеЗначение);
```
Полезно, когда имя реквизита известно только в runtime.

📝 Через форму (для управляемого интерфейса):
```
ЭлементыФормы.ИмяПоля.Значение = НовоеЗначение;
```
Изменяет значение визуально, но не сохраняет его в базе автоматически!

При изменении значений важно учитывать:

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

Также некоторые реквизиты могут быть вычисляемыми (их значение формируется автоматически по формуле). Попытка изменить такое значение программно может не дать эффекта или вызвать ошибку.

Имя реквизита написано без ошибок|

Тип нового значения соответствует типу реквизита|

Реквизит не помечен как "Только чтение"|

Для ссылочных реквизитов используется корректная ссылка, а не строка-->

5. Типичные ошибки при работе со значениями реквизитов

Даже опытные разработчики иногда сталкиваются с ошибками, связанными с реквизитами. Вот самые распространённые:

Несовпадение типов данных:
Пример: попытка записать строку в реквизит типа Число или дату в реквизит типа Булево.

Решение: Преобразуйте значение к нужному типу с помощью функций Число(), Дата(), Строка().
Работа с Неопределено:
Пример: сложение числа с Неопределено или конкатенация строк.

Решение: Всегда проверяйте значения на Неопределено перед операциями.
Ошибки при работе со ссылками:
Пример: присваивание строки («Иванов») вместо ссылки на элемент справочника.

Решение: Используйте методы поиска (НайтиПоНаименованию(), НайтиПоРеквизиту()).
Изменение реквизитов в несохранённом объекте:
Пример: редактирование реквизита документа, который ещё не записан в базу.

Решение: Вызывайте Объект.Записать() перед работой с реквизитами, если это необходимо.

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

ЭтаФорма.Обновить();

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

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

Рассмотрим несколько реальных сценариев работы со значениями реквизитов.

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

Допустим, у нас есть документ ПоступлениеТоваров с реквизитом СуммаДокумента (тип Число). Нам нужно увеличить сумму на 10%:

Док = Документы.ПоступлениеТоваров.НайтиПоНомеру("00000001");
Если Док.Пустая() Тогда
Сообщить("Документ не найден!");
Иначе
ТекущаяСумма = Док.СуммаДокумента;
НоваяСумма = ТекущаяСумма * 1.10;
Док.СуммаДокумента = НоваяСумма;
Док.Записать();
КонецЕсли;

Пример 2: Работа со ссылочным реквизитом

У документа есть реквизит Контрагент (тип СправочникСсылка.Контрагенты). Нужно найти контрагента по наименованию и присвоить его документу:

Контрагент = Справочники.Контрагенты.НайтиПоНаименованию("ООО Ромашка");
Если Контрагент.ПустаяСсылка() Тогда
Сообщить("Контрагент не найден!");
Иначе
Док.Контрагент = Контрагент;
КонецЕсли;

Пример 3: Проверка и заполнение реквизита по умолчанию

Если реквизит ДатаДокумента не заполнен, установим текущую дату:

Если Док.ДатаДокумента = Неопределено Тогда
Док.ДатаДокумента = ТекущаяДата();
КонецЕсли;

Эти примеры иллюстрируют базовые операции, но в реальных задачах часто требуется более сложная логика — например, работа с ХранилищемЗначения или динамическое формирование имён реквизитов.

💡

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

7. Значения реквизитов в обмене данными и интеграциях

При обмене данными между базами 1С или интеграции с внешними системами значения реквизитов играют ключевую роль. Здесь важно учитывать:

🔄 Сопоставление типов данных: В разных базах один и тот же реквизит может иметь разные типы (например, в одной базе Число, в другой — Строка).
🔗 Ссылочная целостность: При обмене ссылками (например, на контрагентов) нужно убедиться, что объекты существуют в обеих базах.
📝 Преобразование значений: Даты, числа и строки могут иметь разный формат в разных системах (например, ДД.ММ.ГГГГ vs ГГГГ-ММ-ДД).

Пример проблемы: при обмене документ содержит реквизит СуммаНДС типа Число(10,2), а во внешней системе это поле строковое. Если не сделать преобразование, обмен завершится с ошибкой.

Решение — использовать функции преобразования:

// Преобразование числа в строку для внешней системы
СтрокаСуммы = Строка(Док.СуммаНДС);

// Обратно: преобразование строки в число
ЧислоСуммы = Число(ЗначениеИзВнешнейСистемы);

⚠️ Внимание: При обмене через Универсальный формат (EnterpriseData) или JSON значения реквизитов автоматически конвертируются в строки. Чтобы избежать потери точности (например, для чисел с плавающей запятой), настройте явное преобразование в правилах обмена.

8. Оптимизация работы с реквизитами: советы для разработчиков

При интенсивной работе с реквизитами (например, в циклах или массовых обработках) важно следить за производительностью. Несколько рекомендаций:

🚀 Минимизируйте обращения к базе: Если вам нужно прочитать несколько реквизитов объекта, сделайте это в одном запросе, а не по отдельности.
🔄 Используйте кэширование: Если одно и то же значение реквизита используется многократно, сохраните его в переменную.
📊 Избегайте лишних проверок: Не проверяйте значение на Неопределено там, где это заведомо не нужно (например, для обязательных реквизитов).
🛠️ Используйте массовые операции: Для изменения реквизитов у группы объектов используйте МассовоеИзменениеРеквизитов() (если доступно в вашей конфигурации).

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

Выборка = Документы.ПоступлениеТоваров.Выбрать();
Пока Выборка.Следующий() Цикл
Док = Выборка.ПолучитьОбъект();
Док.СуммаДокумента = Док.СуммаДокумента * 1.05; // Увеличиваем на 5%
Док.Записать();
КонецЦикла;

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

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

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

Пока ВыборкаРезультат.Следующий() Цикл
Док = ВыборкаРезультат.Ссылка.ПолучитьОбъект();
Док.СуммаДокумента = Док.СуммаДокумента * 1.05;
Док.Записать();
КонецЦикла;

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

FAQ: Частые вопросы о значениях реквизитов в 1С

Как узнать, какой тип данных у реквизита?

Есть несколько способов:

В Конфигураторе: откройте объект (например, справочник), найдите реквизит в дереве и посмотрите его свойства.
Программно: используйте функцию ТипЗнч() для текущего значения или Метаданные().Реквизиты.Найти("ИмяРеквизита").Тип.

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

Нет, тип реквизита задаётся при создании в Конфигураторе и не может быть изменён программно в runtime. Однако вы можете:

Создать новый реквизит с нужным типом и перенести данные.
Использовать ХранилищеЗначения для хранения данных произвольного типа.

Почему при обмене данными теряются значения реквизитов?

Причины могут быть разные:

В правилах обмена не настроено сопоставление для этого реквизита.
Типы данных реквизитов в базах не совпадают.
Реквизит помечен как Необмен в конфигурации.
Ошибки при преобразовании значений (например, строка в число).

Проверьте настройки обмена и логи синхронизации.

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

Используйте метод Получить():

ИмяРеквизита = "СуммаДокумента";
Значение = Объект.Получить(ИмяРеквизита);

Если реквизит вложенный (например, Реквизиты.Сумма), используйте цепочку вызовов или рекурсивный поиск.

Что такое "вычисляемый реквизит" и как с ним работать?

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

ВычисляемоеЗначение = Объект.ВычисляемыйРеквизит;

Формула вычисляемого реквизита может зависеть от других реквизитов объекта. Например, в документе СуммаСНДС = СуммаБезНДС * (1 + СтавкаНДС / 100).

Что такое значение реквизита в 1С: разбор с примерами и нюансами