К статье
Практический материал

Администрирование · 9 мин

Ключи реестра документов в 1С: что это и как с ними работать

Разбираем, что такое ключи реестра документов в 1С: ключ записи регистра, реестр документов, где искать ключи, как их использовать и чего не делать.

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

Чаще всего вопрос возникает у администраторов и разработчиков, когда в сообщении об ошибке, в обмене данными или в отладчике встречается фраза вида «ключ записи регистра» или «конфликт блокировок по ключу». Понимание того, что именно обозначает этот ключ, позволяет быстро найти проблемную запись, не перебирая весь регистр вручную.

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

Что такое ключ записи регистра в 1С

Регистр в 1С — это таблица, где документы оставляют свои движения: остатки товаров, взаиморасчёты, курсы валют, цены. Каждая строка такой таблицы уникальна благодаря комбинации полей. Для регистра сведений это обычно период + набор измерений; для регистра накопления и бухгалтерии к ключу добавляется регистратор — ссылка на документ, который создал запись.

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

Документ при этом сам имеет свой идентификатор — ссылку (GUID), которая тоже часто называется ключом. Ссылка документа неизменна на протяжении всей жизни объекта и используется во всех регистрах, где документ выступает регистратором.

Реестр документов как журнал учёта

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

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

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

Где посмотреть ключи записей и ссылки документов

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

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

В пользовательском режиме удобнее всего работать через «Все функции» (включается в параметрах интерфейса): там доступны все регистры конфигурации, и по отборам можно найти конкретную строку. Навигационная ссылка на документ вида e1cib/data/Документ.РеализацияТоваровУслуг?ref=... содержит в конце как раз внутренний идентификатор объекта.

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

bsl
Запрос = Новый Запрос("ВЫБРАТЬ Период, Контрагент, Договор, Регистратор ИЗ РегистрСведений.ДанныеРеестра ГДЕ Регистратор = &Ссылка"); Запрос.УстановитьПараметр("Ссылка", ДокументСсылка); Результат = Запрос.Выполнить().Выгрузить();

Типичные проблемы, связанные с ключами

Конфликт блокировокДва сеанса меняют одну запись

Технологический журнал, повторное проведение документа

Дубль номера в реестреНарушена нумерация

Настройки нумератора, ручное изменение номеров

Битая ссылкаОбъект удалён, ссылка осталась

Отчёт по битым ссылкам, тестирование и исправление

Запись не находитсяНеверно задан отбор по измерениям

Проверить все поля ключа, включая пустые значения

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

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

Третья — «битые ссылки»: документ удалён физически, а ссылки на его ключ остались в регистрах и других документах. Такие записи отображаются как «<Объект не найден>» и ломают отчёты и обмены.

Типичные ошибки
01
Правка записей регистра напрямую в СУБД — обход логики платформы разрушает целостность и лишает поддержки
02
Ручное изменение номеров документов без обновления нумератора — приводит к дублям в реестре
03
Удаление документов физически без контроля ссылочной целостности — остаются битые ссылки
04
Попытка «починить» конфликт блокировок удалением записи регистра — теряются учётные данные

Что можно и чего нельзя делать с ключами

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

Исправление данных выполняется только инструментами платформы: типовой процедурой «Тестирование и исправление» (с предварительной резервной копией), обработками поиска и удаления помеченных объектов, перепроведением документов. Перед любой массовой операцией сделайте выгрузку базы — это единственная гарантия отката.

Контрольные точки

Как проверить результат исправлений

Тестирование и исправление
Норма

Ошибок ссылочной целостности не выявлено

Тревожный признак

Остаются записи «Объект не найден»

Нумерация реестра
Норма

Новые документы получают следующие свободные номера

Тревожный признак

Появляются дубли или пропуски после сбоя

Проведение документа
Норма

Документ проводится без конфликтов блокировок

Тревожный признак

Ошибка блокировки повторяется при одиночном проведении

Как выбрать способ решения проблемы

Маршрут решения

Как выбрать действие

Ошибка «конфликт блокировок» при параллельной работеПовторите проведение позже; при регулярности — анализируйте режим блокировок и разделители
Дубли номеров в реестре документовОбновите нумерацию и проверьте ручные правки номеров пользователями
В регистрах ссылки на несуществующие документыЗапустите тестирование и исправление с копией базы, затем удалите помеченные объекты
Нужно найти запись по ключу из сообщения об ошибкеИспользуйте консоль запросов с отбором по всем полям ключа

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

Итог

Что важно запомнить

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

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

Чем ключ записи регистра отличается от ссылки документа?

Ссылка (GUID) — идентификатор самого документа как объекта. Ключ записи регистра — комбинация измерений, периода и регистратора, идентифицирующая строку в регистре. Один документ может порождать много записей с разными ключами, но ссылка у него одна.

Можно ли изменить ключ записи регистра?

Нет. Ключ формируется платформой автоматически из значений полей записи. «Изменить» ключ можно только косвенно — изменив значения измерений или периода штатными средствами, что фактически создаёт новую запись.

Почему в реестре документов появились одинаковые номера?

Чаще всего из-за ручного изменения номера пользователем или сбоя автонумерации после обмена данными. Проверьте настройки нумерации и выполните обновление номеров типовой обработкой, предварительно сделав копию базы.

Что делать с записями «Объект не найден» в регистрах?

Это битые ссылки. Запустите «Тестирование и исправление» информационной базы с резервной копией, затем выполните удаление помеченных объектов с контролем ссылочной целостности.

Где посмотреть ключ записи без конфигуратора?

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

Опасно ли читать данные регистров напрямую из SQL?

Чтение безопасно, если не создаёт блокировок, и часто используется для аналитики. Опасна любая запись: изменение или удаление строк в таблицах СУБД в обход платформы нарушает целостность базы.