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

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

Для работы с набором используется менеджер регистра, доступный через свойство глобального контекста РегистрыСведений. Метод СоздатьНаборЗаписей() возвращает пустой набор, который затем заполняется отбором и читается из базы методом Прочитать(). Без установленного отбора чтение вернёт все записи регистра, что на больших таблицах может занять значительное время и память.

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

Как создать набор записей через менеджер регистра

Точка входа — менеджер конкретного регистра сведений. Обращение строится по имени регистра, заданному в конфигураторе:

НаборЗаписей = РегистрыСведений.КурсыВалют.СоздатьНаборЗаписей();

На этом этапе набор пуст: он ещё не содержит данных из информационной базы. Чтобы наполнить его, нужно либо установить отбор и вызвать Прочитать(), либо программно добавить записи методом Добавить() для последующей записи.

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

МенеджерРегистра = РегистрыСведений[ИмяРегистра];
НаборЗаписей = МенеджерРегистра.СоздатьНаборЗаписей();

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

Установка отбора перед чтением

Отбор — ключевой элемент безопасной работы с набором. Он определяет, какие записи попадут в выборку и, что важнее, какие записи будут затронуты при записи. Отбор задаётся через коллекцию Отбор набора записей:

НаборЗаписей = РегистрыСведений.КурсыВалют.СоздатьНаборЗаписей();
НаборЗаписей.Отбор.Валюта.Установить(ВалютаСсылка);
НаборЗаписей.Прочитать();

Для периодического регистра доступен отбор по периоду. Чтобы получить записи за конкретную дату, устанавливают равенство, а для диапазона используют вид сравнения:

НаборЗаписей.Отбор.Период.ВидСравнения = ВидСравнения.БольшеИлиРавно;
НаборЗаписей.Отбор.Период.Значение = НачалоМесяца(ТекущаяДатаСеанса());
НаборЗаписей.Отбор.Период.Использование = Истина;

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

Чтение и перебор записей набора

После вызова Прочитать() набор содержит строки, удовлетворяющие отбору. Их можно перебрать в цикле, проверить количество через Количество() или получить конкретную запись по индексу:

НаборЗаписей.Прочитать();
Для Каждого Запись Из НаборЗаписей Цикл
Сообщить("Курс: " + Запись.Курс + " на " + Запись.Период);
КонецЦикла;

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

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

НаборЗаписей = РегистрыСведений.ЦеныНоменклатуры.СоздатьНаборЗаписей();
НаборЗаписей.Отбор.Номенклатура.Установить(НоменклатураСсылка);
НаборЗаписей.Прочитать();
Если НаборЗаписей.Количество() = 0 Тогда
    Сообщить("Записей по отбору не найдено");
КонецЕсли;

Изменение и запись набора: замещение и добавление

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

Чтобы добавить записи без удаления существующих, используют параметр Замещение = Ложь:

НаборЗаписей = РегистрыСведений.КурсыВалют.СоздатьНаборЗаписей();
НоваяЗапись = НаборЗаписей.Добавить();
НоваяЗапись.Период = ТекущаяДатаСеанса();
НоваяЗапись.Валюта = ВалютаСсылка;
НоваяЗапись.Курс = 92.5;
НаборЗаписей.Записать(Ложь);

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

Особенности периодических и подчинённых регистров

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

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

НаборЗаписей = РегистрыСведений.СтатусыДокументов.СоздатьНаборЗаписей();
НаборЗаписей.Отбор.Регистратор.Установить(ДокументСсылка);
НаборЗаписей.Прочитать();

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

Частые ошибки и проверка результата

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

Для отладки полезно выводить состояние набора до и после операций: количество записей, установленные элементы отбора, признак модифицированности (Модифицированность()). Это позволяет отличить «записей нет в базе» от «записи не прочитались из-за неверного отбора».

FAQ