Другое · 6 мин
Получение записи регистра сведений в 1С
Практические способы получения записи регистра сведений в 1С: по набору измерений, через выборку с отбором и запрос, признаки результата и ограничения.
Регистр сведений в 1С хранит соотношения между измерениями и ресурсами, а конкретная запись идентифицируется значениями измерений, а не порядковым номером. Поэтому получить одну запись можно только при известном и полном наборе измерений, а для периодических регистров дополнительно важны дата и признак активности.
Чтение данных безопасно, а работа через менеджер записи может привести к изменению информации. Операции на запись лучше выполнять после резервного копирования или в копии базы, а в рабочей базе — только при чётком понимании бизнес-логики регистра.
Когда запись считается найденной
Результатом получения должна быть либо одна запись, либо явный признак отсутствия данных. Если система возвращает несколько записей, запрос не идентифицировал единичную строку, и нужно уточнить отбор по дополнительным измерениям или периоду.
Для непериодических регистров достаточно совпадения по измерениям. Для периодических регистров может существовать несколько версий на разные даты, поэтому без указания периода и активности результат может быть неоднозначным.
Получение по точному набору измерений
Самый надёжный способ — обратиться к менеджеру регистра сведений и запросить запись по значениям всех измерений. Если совпадение найдено, возвращается объект записи с текущими значениями ресурсов; если нет — пустой результат или неопределённое значение в зависимости от способа вызова.
Примерная логика на встроенном языке: задать структуру измерений, вызвать получение записи регистра по этой структуре, затем проверить, получен ли объект. Точные имена методов уточняются в синтакс-помощнике под используемую конфигурацию и тип приложения.
Сценарий: константные настройки
Если регистр используется как справочник настроек, запись часто извлекается один раз при открытии формы или запуске обработки. В этом случае целесообразно кэшировать результат в переменной модуля, чтобы не повторять обращение к регистру при каждом расчёте.
Сценарий: периодические показатели
Для показателей, меняющихся со времени, нужно указать дату на момент расчёта и проверить активность записи. Иначе может быть выбрана устаревшая или ещё не вступившая в силу версия.
- 1Задать значения всех измерений регистра.
- 2Вызвать получение записи по этому набору.
- 3Проверить, что объект записи получен, а не пустой результат.
- 4При необходимости считать значения ресурсов из полученной записи.
Выборка с отбором и неточным поиском
Когда полный набор измерений неизвестен, используется выборка с отбором. Например, можно отобрать все записи, где одно измерение равно заданному значению, а затем в цикле проверить остальные условия. Такой подход подходит для поиска, но не гарантирует получение единственной записи.
Важно ограничить выборку условиями и, при возможности, задать сортировку. Без сортировки порядок записей может зависеть от реализации хранения, и доверие к «первой попавшейся» записи ведёт к нестабильным результатам.
Запрос к виртуальной таблице регистра
Через язык запросов можно обратиться к виртуальной таблице регистра сведений, указав нужные измерения, ресурсы и условия в секции ГДЕ. Этот способ удобен, когда нужно получить сразу несколько записей, агрегировать данные или соединить регистр с другими таблицами.
Запрос подходит для отчётов и массовой обработки, но для получения одной конкретной записи всё равно стоит добавить ограничение на уникальность набора измерений и проверить количество возвращённых строк.
Менеджер записи и изменение данных
Если нужно не только прочитать, но и изменить запись, используется менеджер записи регистра сведений. После получения или создания менеджера заполняются значения ресурсов и выполняется запись. Прямое изменение регистра обходит обычные документы и может нарушить зависимые расчёты.
Рекомендуется изменять данные регистра через документы или специальные операции конфигурации, а не напрямую через скрипт. Прямая правка допустима только для исправления очевидных ошибок и после согласования с ответственным за учёт.
Как проверить результат
Объект не пустой и содержит ожидаемые ресурсы
Пустой результат или несоответствие измерений
Дата и активность совпадают с моментом расчёта
Выбрана устаревшая или будущая версия
Одна запись при полном наборе измерений
Несколько записей без уточняющего отбора
Проверка результата и ограничения
После получения записи нужно проверить: объект существует, значения измерений совпадают с искомыми, для периодического регистра подходит дата и активность, ресурсы заполнены корректно. Если запись отсутствует, это может означать либо отсутствие данных, либо ошибку в наборе измерений.
Ограничение по производительности проявляется при частом получении записей в циклах по большому количеству строк. В таких случаях эффективнее один раз загрузить нужный набор через запрос или выборку, а затем работать с данными в памяти.
Частые ошибки и что не стоит делать
Одна из типичных ошибок — попытка получить запись по частичному набору измерений и ожидание единственного результата. В этом случае система может вернуть несколько строк или первую попавшуюся, что ведёт к некорректным расчётам.
Другая ошибка — прямое изменение регистра без понимания движений данных и без тестирования на копии базы. Это может повредить отчёты, закрытые периоды и связанные с регистром документы. Не стоит полагаться на несортированную выборку как на источник единственной записи.
Что важно запомнить
Запись регистра сведений определяется полным набором измерений, для периодических регистров — ещё и датой с активностью; чтение безопасно, запись требует осторожности и проверки результата.
Можно ли получить запись без всех измерений?
Нет, конкретную запись идентифицирует полный набор измерений. При частичном отборе можно получить выборку из нескольких записей, но не единственную строку.
Чем отличаются периодические и непериодические регистры?
В непериодических достаточно совпадения по измерениям. В периодических одна комбинация измерений может иметь несколько версий по датам, поэтому нужно указывать период и проверять признак активности.
Что делать, если найдено несколько записей?
Нужно уточнить отбор дополнительными измерениями, датой или активностью, задать сортировку и выбрать нужную запись явно, а не полагаться на порядок возврата.
Безопасно ли менять запись через менеджер записи?
Только при чётком понимании логики регистра и после резервного копирования или тестирования на копии базы. В обычной работе изменения лучше вносить через документы и регламентные операции конфигурации.