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

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

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

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

Просмотр реквизитов в конфигураторе

Самый быстрый способ узнать, какие реквизиты есть у регистра, — открыть конфигуратор, найти в дереве объектов ветку «Регистры накопления» и раскрыть нужный регистр. Внутри него отображаются подветки «Измерения», «Ресурсы» и «Реквизиты». Двойной клик по элементу открывает палитру свойств с типом, длиной, обязательностью заполнения и другими параметрами.

Дополнительно полезно открыть окно свойств самого регистра и вкладку «Данные» — там вся структура показана единым списком с типами. Если конфигурация на поддержке и заблокирована для изменений, просмотр структуры всё равно доступен — ограничение касается только редактирования.

Получение реквизитов программно через метаданные

Для универсальных обработок состав реквизитов получают через объект «Метаданные». Коллекция реквизитов конкретного регистра доступна так:

РегистрМД = Метаданные.РегистрыНакопления["ТоварыНаСкладах"];
Для Каждого Реквизит Из РегистрМД.Реквизиты Цикл
Сообщить(Реквизит.Имя + " — " + Строка(Реквизит.Тип));
КонецЦикла;

У объекта описания реквизита доступны свойства: Имя, Синоним, Тип (объект «ОписаниеТипов»), Комментарий. Аналогично обходятся коллекции Измерения и Ресурсы. Если имя регистра заранее неизвестно, можно перебрать всю коллекцию Метаданные.РегистрыНакопления и отобрать регистры по условию.

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

РегистрМД = Метаданные.РегистрыНакопления["ТоварыНаСкладах"];
Для Каждого Реквизит Из РегистрМД.Реквизиты Цикл
    Сообщить(Реквизит.Имя + " | " + Реквизит.Синоним);
КонецЦикла;

Чтение значений реквизитов из движений запросом

Реквизиты хранятся в физической таблице регистра накопления и доступны в запросе наравне с измерениями. Запрос к таблице движений выглядит так:

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

Здесь НомерЗаказа — пример пользовательского реквизита. Обратите внимание: в виртуальных таблицах «Остатки» реквизиты недоступны, потому что остатки агрегируются только по измерениям. Реквизиты присутствуют в физической таблице и в таблице «Обороты» — но в оборотах их использование в группировке резко увеличивает детализацию результата.

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

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

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

1. 1
   Откройте документ, формирующий движения по нужному регистру
2. 2
   Через меню «Ещё» откройте движения документа или отчёт по проводкам регистра
3. 3
   Найдите в списке таблиц нужный регистр накопления
4. 4
   Настройте видимость колонок, если часть реквизитов скрыта
5. 5
   Сверьте значения реквизитов с ожидаемыми по данным документа

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

Когда движения обрабатываются программно — например, в обработчике проведения или при загрузке данных, — реквизиты читаются и заполняются через набор записей регистра:

НаборЗаписей = РегистрыНакопления.ТоварыНаСкладах.СоздатьНаборЗаписей();
НаборЗаписей.Отбор.Регистратор.Установить(СсылкаНаДокумент);
НаборЗаписей.Прочитать();
Для Каждого Запись Из НаборЗаписей Цикл
НомерЗаказа = Запись.НомерЗаказа; // чтение реквизита
КонецЦикла;

При проведении документа движения обычно формируются через коллекцию Движения объекта документа: Движения.ТоварыНаСкладах. Каждая добавленная строка движения позволяет присвоить значение реквизиту так же, как измерению. Если реквизит не заполнить, он останется пустым — платформа не проверяет обязательность реквизитов автоматически, если это не настроено отдельно.

Сравнение способов и типичные ошибки

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

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