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

Другое · 7 мин

Получение GUID документа в 1С

Как получить GUID документа в 1С: программно через ссылку, в конфигураторе и отладчике, способы проверки, ограничения и типичные ошибки при работе с идентификаторами.

GUID документа в 1С — это уникальный идентификатор объекта в информационной базе. Он позволяет безошибочно сослаться на конкретный документ при обмене данными, интеграции с внешними системами и программном доступе из кода. Внутри одной базы идентификатор остаётся стабильным для данного документа, пока объект не удалён и не восстановлен особым образом.

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

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

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

Что такое GUID документа в 1С и зачем он нужен

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

Идентификатор востребован при обмене данными между информационными базами, при интеграции с внешними сайтами и сервисами, а также при вызове 1С из сторонних приложений через COM-соединение или веб-сервисы. В таких случаях ссылка на документ по номеру может быть недостаточно надёжной.

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

Получение GUID программно: основные способы

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

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

Порядок действий программно
  1. 1
    Откройте модуль объекта или формы документа
  2. 2
    Получите ссылку на нужный документ
  3. 3
    Обратитесь к свойству уникального идентификатора ссылки
  4. 4
    Преобразуйте значение в строку при необходимости
  5. 5
    Проверьте, что строка не пустая

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

Независимо от способа, после получения GUID рекомендуется убедиться, что строка не пустая и соответствует ожидаемому документу. Пустое значение может означать, что объект ещё не сохранён или ссылка неполная.

Получение GUID через конфигуратор и отладчик

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

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

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

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

Проверка результата и границы безопасного применения

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

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

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

Значение GUID
Норма

Непустая строка, одинаковая при повторном получении

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

Пустая строка или разные значения для одного документа

Принадлежность к базе
Норма

Одна и та же информационная база

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

Разные базы или копии базы

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

Также не стоит хранить GUID в открытом виде там, где это может раскрыть структуру базы или внутренние ссылки. Хотя сам идентификатор не содержит чувствительных данных, он позволяет точнее нацеливаться на объекты при несанкционированном доступе.

Частые ошибки и ограничения

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

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

Типичные ошибки
01
Путаница GUID с номером документа — номер не гарантирует уникальности
02
Попытка получить GUID у несохранённого объекта — значение может быть пустым
03
Использование GUID как межбазового ключа — идентификаторы могут измениться при копировании базы

Ограничение заключается в том, что GUID привязан к одной информационной базе. Перенос данных, выгрузка и загрузка или обновление конфигурации могут привести к изменению или потере идентификаторов, если процесс не предусматривает их сохранение.

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

Итог

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

GUID документа в 1С получают через ссылку, запрос или отладчик, проверяют на пустоту и не используют как стабильный ключ между разными базами.

Можно ли получить GUID документа без программирования?

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

Изменится ли GUID после проведения документа?

Обычно проведение документа не меняет его уникальный идентификатор. GUID остаётся привязанным к объекту в рамках одной базы, пока документ не удалён и не восстановлен особым образом.

Почему GUID может быть пустым?

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

Безопасно ли хранить GUID во внешней системе?

Можно хранить для связки с конкретной базой, но не полагайтесь на него при переносе данных между разными информационными базами. Идентификаторы могут не совпадать после копирования или восстановления.

Чем GUID отличается от номера документа?

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