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

Другое · 6 мин

Запись уникального идентификатора в 1С: порядок и проверка

Как в 1С создать и записать ГУИД в реквизит: тип данных, присваивание, проверка пустого значения, ошибки и способы подтверждения результата.

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

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

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

Что такое уникальный идентификатор в 1С

Тип УникальныйИдентификатор встроен в платформу и предназначен для генерации Globally Unique Identifier. Значение не зависит от порядкового номера документа, кода справочника или даты создания. Оно может совпадать крайне редко, поэтому подходит для идентификации записей при выгрузке, загрузке и синхронизации.

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

Порядок записи идентификатора
  1. 1
    Проверьте тип реквизита в конфигураторе
  2. 2
    Создайте значение через Новый УникальныйИдентификатор
  3. 3
    Присвойте значение реквизиту объекта
  4. 4
    Запишите объект
  5. 5
    Проверьте, что реквизит не пустой

Как создать и записать идентификатор в реквизит

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

Пример логики на сервере может выглядеть так: создайте функцию, возвращающую Новый УникальныйИдентификатор, и вызовите её при заполнении документа. Если объект уже записан, изменение идентификатора требует перезаписи и может повлиять на связанные данные.

Где использовать идентификатор, а где не стоит

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

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

Типичные ошибки
01
Запись GUID в строковый реквизит вместо типа УникальныйИдентификатор
02
Ручной ввод или исправление идентификатора пользователем
03
Сравнение идентификаторов как обычных строк без приведения типа

Как проверить, что идентификатор записан корректно

После записи объекта прочитайте его обратно и убедитесь, что реквизит не равен пустому идентификатору. В 1С проверка обычно выполняется через сравнение со значением УникальныйИдентификатор().Пустой() или через преобразование в строку и проверку на пустоту.

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

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

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

Реквизит типа УникальныйИдентификатор уже существуетПрисваивайте Новый УникальныйИдентификатор при создании объекта
Реквизита нет или тип не подходитДобавьте реквизит в конфигураторе, затем записывайте идентификатор программно
Нужно обменяться данными с другой базойИспользуйте строковое представление при экспорте и конструктор УникальныйИдентификатор при импорте

Типичные ошибки и ограничения

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

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

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

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

Реквизит после записи
Норма

Значение не пустое и имеет тип УникальныйИдентификатор

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

Пустое значение, тип Строка или ошибка записи

Обмен данными
Норма

Идентификатор распознаётся на принимающей стороне

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

Ошибка импорта или дублирование записей

Как выбрать способ записи

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

Контрольные точки перед завершением

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

Итог

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

Идентификатор создаётся платформой, записывается в реквизит типа УникальныйИдентификатор и проверяется на пустоту; не заменяйте им пользовательский номер и не храните как обычную строку без преобразования.

Нужно ли вручную придумывать уникальный идентификатор?

Нет. В 1С значение создаётся платформой через Новый УникальныйИдентификатор. Ручной ввод повышает риск ошибок и нарушения формата.

Можно ли сохранить идентификатор в обычное строковое поле?

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

Как проверить, что идентификатор не пустой?

Сравните значение реквизита с пустым идентификатором или преобразуйте в строку и проверьте на пустоту. Если объект записан, но реквизит пуст, запись не выполнила свою задачу.

Подходит ли идентификатор для пользовательского номера документа?

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