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