Как правильно записать УникальныйИдентификатор (GUID) в реквизит объекта 1С

Программист 1С v8.3 (Управляемые формы) IT и автоматизация бизнеса
← На главную

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

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

1. Выясним причину ошибки: почему код в событиях модуля не заполняет реквизит

Рассмотрим распространенную ошибку, с которой сталкиваются разработчики. Допустим, в модуле объекта записан следующий код:


Процедура ПриЗаписи(Отказ)
    ЭтотОбъект.УникальныйИдентификаторСтрока = Строка(Ссылка.УникальныйИдентификатор());
КонецПроцедуры

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

  1. Неверный выбор события: Событие ПриЗаписи срабатывает в тот момент, когда объект уже записан в базу данных в рамках транзакции. Все изменения свойств объекта ЭтотОбъект, внесенные в процедуре ПриЗаписи, изменяют лишь данные в оперативной памяти текущего экземпляра, но в базу данных уже не попадают. Повторный вызов метода Записать() внутри ПриЗаписи приведет к зацикливанию системы.
  2. Неверный модуль: Обработчики событий конкретного экземпляра (такие как ПередЗаписью или ПриЗаписи) должны располагаться исключительно в модуле объекта, а не в модуле менеджера.
  3. Отсутствие ссылки у нового объекта: Если объект создает новый элемент справочника, у него еще нет физической записи в таблицах БД, а значит, обращение к значению Ссылка.УникальныйИдентификатор() не вернет сформированный идентификатор без предварительной установки ссылки нового.

2. Как получить УникальныйИдентификатор у нового объекта

Разберем логику работы платформы 1С:Предприятие при создании нового объекта. По умолчанию ссылка для нового элемента генерируется платформой непосредственно в момент физической записи в базу данных. Однако разработчик имеет возможность сформировать ссылку заранее в оперативной памяти с помощью метода УстановитьСсылкуНового().

Рассмотрим, как правильно сгенерировать УникальныйИдентификатор и назначить его новому элементу в событии ПередЗаписью:


Процедура ПередЗаписью(Отказ, РежимЗаписи, РежимПроведения)
    
    Если ЭтоНовый() Тогда
        // 1. Создаем новый УникальныйИдентификатор
        НовыйУИД = Новый УникальныйИдентификатор;
        
        // 2. Формируем ссылку на основе созданного УИД
        БудущаяСсылка = Справочники.ХарактеристикиНоменклатуры.ПолучитьСсылку(НовыйУИД);
        
        // 3. Назначаем эту ссылку текущему объекту
        ЭтотОбъект.УстановитьСсылкуНового(БудущаяСсылка);
        
        // 4. Записываем текстовое представление УИД в строковый реквизит
        ЭтотОбъект.УникальныйИдентификаторСтрока = Строка(НовыйУИД);
    КонецЕсли;

КонецПроцедуры

В этом коде процедура ПередЗаписью срабатывает до того, как данные отправятся в базу данных. Все изменения, внесенные в реквизиты объекта ЭтотОбъект на данном этапе, будут успешно сохранены в БД.

3. Посмотрим на безопасный алгоритм с учетом повторного вызова и обмена данными

На практике приведенный выше простой пример требует двух важных дополнений:

  1. Проверка на режим загрузки данных: Если в базе настроен обмен (например, через РИБ, КД2/КД3 или интеграционные сервисы), при загрузке объекта из другой системы событие ПередЗаписью также будет вызываться. Если не проверить свойство ОбменДанными.Загрузка, платформа заново перегенерирует GUID объекта, что приведет к рассинхронизации данных между базами.
  2. Проверка ранее установленной ссылки: Ссылка новому объекту может быть сформирована еще до вызова метода записи (например, в форме объекта или внешнем алгоритме заполнения). В таком случае пересоздавать ссылка заново не требуется — достаточно прочитать уже имеющуюся.

Рассмотрим итоговый универсальный алгоритм для модуля объекта:


Процедура ПередЗаписью(Отказ, РежимЗаписи, РежимПроведения)
    
    // Если происходит загрузка данных из внешних систем, отключаем логику переопределения
    Если ОбменДанными.Загрузка Тогда
        Возврат;
    КонецЕсли;
    
    // Обрабатываем только новые объекты
    Если ЭтоНовый() Тогда
        
        // Проверяем, не была ли ссылка создана и установлена ранее
        БудущаяСсылка = ПолучитьСсылкуНового();
        
        Если НЕ ЗначениеЗаполнено(БудущаяСсылка) Тогда
            // Если ссылка пустая, генерируем новый GUID и устанавливаем ссылку новому объекту
            НовыйУИД = Новый УникальныйИдентификатор;
            БудущаяСсылка = Справочники.ХарактеристикиНоменклатуры.ПолучитьСсылку(НовыйУИД);
            УстановитьСсылкуНового(БудущаяСсылка);
        Иначе
            // Если ссылка уже была установлена ранее, извлекаем ее GUID
            НовыйУИД = БудущаяСсылка.УникальныйИдентификатор();
        КонецЕсли;
        
        // Сохраняем строковое представление GUID в реквизит
        УникальныйИдентификаторСтрока = Строка(НовыйУИД);
        
    КонецЕсли;

КонецПроцедуры

4. Важная информация по работе с Уникальным Идентификатором

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

Читайте также

5 материалов по теме
  1. 01 Почему не сохраняется значение реквизита в процедуре ПриЗаписи и как это исправить
  2. 02 Как создать элемент справочника с заданным GUID и почему он меняется при записи
  3. 03 Как получить ссылку нового документа при его первой записи и сохранить в реквизит?
  4. 04 Как программно записать GUID в реквизит справочника 1С 7.7 для переноса данных в 8.3?
  5. 05 Как программно найти и заменить документ по GUID в 1С:Предприятии 8?
← На главную