Получает уникальный идентификатор ссылки. Ссылка может быть получена из уникального идентификатора с помощью метода менеджера ПолучитьСсылку.
Синтаксис
УникальныйИдентификатор()Полное описание, параметры и ограничения
ДокументСсылка.<Имя документа>.УникальныйИдентификатор (DocumentRef.<Document name>.UUID)
ДокументСсылка.<Имя документа> (DocumentRef.<Document name>)
УникальныйИдентификатор (UUID)
Доступен, начиная с версии 8.0.
Синтаксис:
УникальныйИдентификатор()
Возвращаемое значение:
Тип: УникальныйИдентификатор.
Описание:
Получает уникальный идентификатор ссылки.
Ссылка может быть получена из уникального идентификатора с помощью метода менеджера ПолучитьСсылку.
Доступность:
Тонкий клиент, веб-клиент, сервер, толстый клиент, внешнее соединение, мобильное приложение (сервер), мобильный автономный сервер.
См. также:
ДокументМенеджер.<Имя документа>, метод ПолучитьСсылку
Использование в версии:
Доступен, начиная с версии 8.0.
Методическая информация
Практические примеры
Назначить своему новому черновику ссылку будущей записи
UUID генерируется уроком, менеджер создаёт значение ссылки, а объект хранит её назначение для будущей записи. ПолучитьСсылкуНового не выполняет сохранение.
Где и как запускать
Полный серверный модуль новой собственной Учебная85, точная 8.5.1.1343. Непроводимая заявка; временные собственные записи только с отменой транзакции. Код здесь не запускался.
Подготовка
Создайте НОВУЮ пустую файловую учебную базу, не копию рабочего каталога. В Конфигураторе задайте корню имя Учебная85. Не добавляйте эти объекты в рабочую УТ/КА2/УНФ/БП.
Справочники → Добавить: имя УчебныеТовары. Длина кода 10, тип кода Строка, автонумерация и контроль уникальности включены, длина наименования 100.
Для УчебныеТовары включите иерархию групп и элементов. Добавьте реквизиты Артикул (Строка, длина 20) и Цена (Число, 12 цифр, 2 дробных, неотрицательное). Проверка заполнения для этих учебных реквизитов не устанавливается.
Добавьте табличную часть Штрихкоды: Штрихкод (Строка, длина 20) и Основной (Булево). Обновите конфигурацию базы данных. Модули объектов оставьте пустыми.
Документы → Добавить: имя УчебнаяЗаявка, тип номера Строка, длина 9, автонумерация включена. Проведение запретите: это только учебный документ без движений.
Добавьте реквизит Комментарий (Строка, длина 100) и табличную часть Товары: Товар (СправочникСсылка.УчебныеТовары), Количество (Число, 9 цифр, 0 дробных, неотрицательное), Цена (Число, 12 цифр, 2 дробных, неотрицательное). Модуль документа пустой.
Обновите конфигурацию базы данных. Эти имена существуют только в созданной учебной конфигурации, не подразумеваются в типовой базе.
У своего документа и товара модули пустые, подписок, расширений и внешних обработчиков нет. История данных выключена; проведение УчебнаяЗаявка запрещено, движения/регистры не создаются.
Номер заявки здесь строковый длиной 9, с автонумерацией. Для иной числовой нумерации нельзя копировать проверки Строка. Дата задаётся собственным литералом, не читается из рабочего документа.
Свойства ссылки readonly. Непустой UUID/ссылка не означает наличие записи, а ВерсияДанных — непрозрачная строка, не номер документа или версия конфигурации.
Примеры здесь не запускались в 1С. Только код и установленная справка 8.5.1.1343; ваши документы не создавались, не проводились и не удалялись.
Создайте серверный общий модуль УчебныеСсылкиДокументов и вставьте весь модуль одного урока. ВыполнитьПример() Экспорт вызывайте из своей процедуры формы с &НаСервереБезКонтекста; обновите конфигурацию БД.
Для этого блока корень Учебная85, единственный справочник УчебныеТовары, единственный непроводимый документ УчебнаяЗаявка; регистров нет. Модули объекта/менеджера и подписки пустые, история выключена, расширений, обменов и фоновых заданий нет.
Запускайте полный модуль одного урока отдельно, единственным пользователем. Нельзя заменять проверки имени/схемы рабочими объектами или передавать документ, найденный по первой строке.
Уроки с записью/пометкой/удалением сами создают новый товар и новую заявку внутри своей транзакции, отслеживают только их ссылки и отменяют всё при успехе/ошибке. Фиксации нет; не вызывайте их внутри чужой транзакции.
Уроки черновика/времени/макета вообще не записывают документы. Все помощники и подготовленные данные предоставлены в полном модуле, внешняя библиотека не нужна.
Прямое Удалить не проверяет ссылочную целостность; откат учебной транзакции не делает этот метод безопасным для рабочего документа. Допустима только своя новая пустая база без внешних обработчиков. Здесь 1С не запускалась.
Процедура ВыполнитьПример() Экспорт
Если Метаданные.Справочники.Найти("УчебныеТовары") = Неопределено Тогда
ВызватьИсключение "Сначала создайте учебный справочник по подготовке";
КонецЕсли;
Если Метаданные.Документы.Найти("УчебнаяЗаявка") = Неопределено Тогда
ВызватьИсключение "Сначала подготовьте собственную УчебнаяЗаявка";
КонецЕсли;
Если Метаданные.Справочники.Количество() <> 1
Или Метаданные.Документы.Количество() <> 1
Или Метаданные.РегистрыНакопления.Количество() <> 0
Или Метаданные.РегистрыСведений.Количество() <> 0
Или Метаданные.РегистрыБухгалтерии.Количество() <> 0 Тогда
ВызватьИсключение "Нужны только собственные товар и непроводимая заявка, без регистров";
КонецЕсли;
Черновик = Документы.УчебнаяЗаявка.СоздатьДокумент();
Черновик.Дата = Дата(2026, 10, 6, 12, 0, 0);
Черновик.Комментарий = "Собственный черновик с плановым идентификатором";
Идентификатор = Новый УникальныйИдентификатор;
Плановая = Документы.УчебнаяЗаявка.ПолучитьСсылку(Идентификатор);
Если Плановая.ПолучитьОбъект() <> Неопределено Тогда
ВызватьИсключение "Плановая собственная ссылка неожиданно существует";
КонецЕсли;
Черновик.УстановитьСсылкуНового(Плановая);
Подготовленная = Черновик.ПолучитьСсылкуНового();
Сообщить(Подготовленная = Плановая);
Сообщить(Подготовленная.УникальныйИдентификатор() = Идентификатор);
Сообщить(Черновик.ЭтоНовый());
Сообщить(Подготовленная.ПолучитьОбъект() = Неопределено);
Сообщить("Получено назначение ссылки для будущей записи, но документ в базе не создан");
КонецПроцедурыРазбор по шагам
Создать только свой новый черновик и явно установить дату/комментарий.
Сгенерировать UUID, получить ссылку именно менеджером УчебнаяЗаявка.
Проверить отсутствие записи этой ссылки; это не поиск существующего документа по коду.
УстановитьСсылкуНового принимает ДокументСсылка, не строку UUID.
ПолучитьСсылкуНового должен вернуть назначенную ссылку и исходный идентификатор.
Проверить ЭтоНовый и отсутствие записи. Уникальность при будущей записи проверит платформа; здесь Записать не вызывается.
Как проверить результат
Четыре сообщения Истина: назначение, UUID, новый объект и отсутствие записи.
UUID непустой, но документ в информационной базе не появился.
Исходный номер/дату существующего документа код не использует.
Ожидаемый результат
Показана подготовка идентичности своего будущего документа без подмены её наличием записи.
На что обратить внимание
Непустая ссылка не доказывает существование записи; плановую ссылку не читать как сохранённый документ.
Модифицированность относится к локальным изменениям объекта после чтения, не к изменениям другими пользователями. ВерсияДанных — непрозрачная readonly-строка.
Заблокирован относится к блокировке именно этим объектом языка; это не общий индикатор всех блокировок записи. Собственную явную блокировку освобождайте отдельно, не рассчитывайте только на откат.
Пометка не удаляет запись, а прямое Удалить удаляет сразу без проверки ссылок. Если документ проведён, установка пометки отменяет проведение; модифицированный объект перед пометкой вызывает ошибку.
Статические проверки по справке и тексты контрольных условий не являются выполнением BSL в 1С.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.
Создать собственную ссылку заявки без записи документа
Пустая и плановая ссылки создаются функциональным Новый из прикладного Тип. Второй аргумент — массив с новым UUID; это ещё не запись документа.
Где и как запускать
Полный серверный модуль новой пустой Учебная85; платформа 8.5.1.1343. Собственные товар/заявка, запись без проведения только с откатом; здесь не запускался.
Подготовка
Создайте НОВУЮ пустую файловую учебную базу, не копию рабочего каталога. В Конфигураторе задайте корню имя Учебная85. Не добавляйте эти объекты в рабочую УТ/КА2/УНФ/БП.
Справочники → Добавить: имя УчебныеТовары. Длина кода 10, тип кода Строка, автонумерация и контроль уникальности включены, длина наименования 100.
Для УчебныеТовары включите иерархию групп и элементов. Добавьте реквизиты Артикул (Строка, длина 20) и Цена (Число, 12 цифр, 2 дробных, неотрицательное). Проверка заполнения для этих учебных реквизитов не устанавливается.
Добавьте табличную часть Штрихкоды: Штрихкод (Строка, длина 20) и Основной (Булево). Обновите конфигурацию базы данных. Модули объектов оставьте пустыми.
Документы → Добавить: имя УчебнаяЗаявка, тип номера Строка, длина 9, автонумерация включена. Проведение запретите: это только учебный документ без движений.
Добавьте реквизит Комментарий (Строка, длина 100) и табличную часть Товары: Товар (СправочникСсылка.УчебныеТовары), Количество (Число, 9 цифр, 0 дробных, неотрицательное), Цена (Число, 12 цифр, 2 дробных, неотрицательное). Модуль документа пустой.
Обновите конфигурацию базы данных. Эти имена существуют только в созданной учебной конфигурации, не подразумеваются в типовой базе.
У своего документа и товара модули пустые, подписок, расширений и внешних обработчиков нет. История данных выключена; проведение УчебнаяЗаявка запрещено, движения/регистры не создаются.
Номер заявки здесь строковый длиной 9, с автонумерацией. Для иной числовой нумерации нельзя копировать проверки Строка. Дата задаётся собственным литералом, не читается из рабочего документа.
Свойства ссылки readonly. Непустой UUID/ссылка не означает наличие записи, а ВерсияДанных — непрозрачная строка, не номер документа или версия конфигурации.
Примеры здесь не запускались в 1С. Только код и установленная справка 8.5.1.1343; ваши документы не создавались, не проводились и не удалялись.
Создайте серверный общий модуль УчебныеСсылкиДокументов и вставьте весь модуль одного урока. ВыполнитьПример() Экспорт вызывайте из своей процедуры формы с &НаСервереБезКонтекста; обновите конфигурацию БД.
Опыт записи допускается только вне чужой транзакции. Внутри собственной транзакции создаются один свой новый товар и одна своя заявка, затем обе записи отменяются при успехе и при ошибке.
Откат базы не отменяет внешние действия обработчиков, поэтому допускается лишь подготовленная новая пустая база. Не заменяйте ОтменитьТранзакцию фиксацией.
Процедура ВыполнитьПример() Экспорт
Если Метаданные.Справочники.Найти("УчебныеТовары") = Неопределено Тогда
ВызватьИсключение "Сначала создайте учебный справочник по подготовке";
КонецЕсли;
Если Метаданные.Документы.Найти("УчебнаяЗаявка") = Неопределено Тогда
ВызватьИсключение "Сначала подготовьте собственную УчебнаяЗаявка";
КонецЕсли;
ТипСсылки = Тип("ДокументСсылка.УчебнаяЗаявка");
Пустая = Новый(Тип("ДокументСсылка.УчебнаяЗаявка"));
Идентификатор = Новый УникальныйИдентификатор;
Параметры = Новый Массив;
Параметры.Добавить(Идентификатор);
Плановая = Новый(Тип("ДокументСсылка.УчебнаяЗаявка"), Параметры);
Сообщить(ТипЗнч(Пустая) = ТипСсылки);
Сообщить(Пустая.Пустая());
Сообщить(Пустая = Документы.УчебнаяЗаявка.ПустаяСсылка());
Сообщить(Не Плановая.Пустая());
Сообщить(Плановая.УникальныйИдентификатор() = Идентификатор);
Сообщить(Плановая = Документы.УчебнаяЗаявка.ПолучитьСсылку(Идентификатор));
Сообщить(Плановая.ПолучитьОбъект() = Неопределено);
Сообщить("Конструктор создал ссылку, но не запись в базе");
КонецПроцедурыРазбор по шагам
Подготовить свою УчебнаяЗаявка в новой пустой Учебная85.
Создать пустую ссылку и сравнить с ПустаяСсылка менеджера.
Создать новый UUID, добавить его одним элементом в Массив.
Создать плановую ссылку, сравнить её UUID и ПолучитьСсылку.
Проверить отсутствие объекта; номер, дату и проведение отсутствующего документа не читать.
Как проверить результат
Семь сравнений Истина.
Ни товар, ни документ не записан.
Непустой UUID не принят за существующую заявку.
Ожидаемый результат
Конструктор ссылки документа использован на собственном новом UUID без записи.
На что обратить внимание
Дата документа — его реквизит, не дата фактической записи и не гарантированный UTC. Здесь сравнивается один заданный собственный литерал.
Проведен и ПометкаУдаления не являются номером, правами доступа или подтверждением бизнес-корректности.
Скопировать возвращает новый объект, не сохранённую ссылку. Номер/дату копии не считайте гарантированно одинаковыми с исходником.
Только свои записи создаются внутри новой транзакции и откатываются; рабочие документы и движения не используются.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.