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

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

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

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

Что именно называют ключом реестра документов

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

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

Где физически хранится ключ

Ссылка документа хранится в основной таблице документа в базе данных и дублируется во всех таблицах, где документ выступает регистратором или значением реквизита. При файловом режиме работы это таблицы внутри файла 1Cv8.1CD, при клиент-серверном — таблицы в СУБД (MS SQL, PostgreSQL и другие). Прямой доступ к этим таблицам в обход платформы не рекомендуется: платформа кэширует данные, и ручное изменение таблиц приводит к рассогласованию.

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

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

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

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

1. 1
   Откройте нужный документ в режиме предприятия
2. 2
   Скопируйте навигационную ссылку через меню формы или адресную строку веб-клиента
3. 3
   Извлеките часть после ref= — это внутреннее представление ссылки
4. 4
   Для получения привычного GUID используйте консоль запросов или конфигуратор
5. 5
   Проверьте результат, открыв документ по полученной ссылке

Как получить ключ программно в конфигураторе

Разработчику доступны штатные методы встроенного языка. Для ссылки документа используется метод УникальныйИдентификатор() объекта ссылки, а обратное преобразование выполняется через ПолучитьСсылку(). Для ключа записи регистра сведений применяется метод СоздатьКлючЗаписи менеджера регистра с передачей структуры значений измерений.

// GUID документа
ГУИД = СсылкаНаДокумент.УникальныйИдентификатор();

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

// Ключ записи регистра сведений
Ключ = РегистрыСведений.СтатусыДокументов.СоздатьКлючЗаписи(Новый Структура("Документ", СсылкаНаДокумент));

При работе с ПолучитьСсылку() есть важный нюанс: если объекта с таким GUID в базе нет, метод вернёт «пустую» ссылку с заданным идентификатором, и обращение к её реквизитам вызовет ошибку. Поэтому после получения ссылки корректно проверять существование объекта запросом или методом ПолучитьОбъект() с обработкой исключения.

Зачем ключ нужен при обмене данными

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

Типичная проблема — дубли документов после обмена. Она возникает, когда объект создавался независимо в обеих базах и получил разные GUID. Система видит два разных ключа и не объединяет записи автоматически. Решение — ручное сопоставление в регистре соответствия объектов либо перенумерация с переносом ссылки штатными средствами конвертации.

Типичные ошибки и как их избежать

Отдельная ошибка — путать ключ записи регистра накопления с ключом регистра сведений. У регистров накопления нет ключа записи в таком виде: строки там идентифицируются регистратором и номером строки. Попытка получить «ключ записи» движения документа штатным методом регистра сведений закончится ошибкой компиляции или исполнения.

Как проверить, что ключ корректен

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

Если документ отображается в журнале, но по ссылке не открывается с ошибкой «Объект не найден», это признак битой ссылки — записи в реестре есть, а самого объекта нет. Такое случается после некорректного удаления или сбоя обмена. Лечится тестированием и исправлением базы с включённой проверкой ссылочной целостности.

FAQ