СправочникСсылка.<Имя справочника>.ИмяПредопределенныхДанных

Сравнить readonly-паспорт ссылки с собственным сохранённым объектом

В отменяемой транзакции создаётся свой товар. Через настоящую ссылку читаются его код, имя, признаки и непрозрачная версия, без присваивания readonly-полям.

Подготовка

1. Создайте НОВУЮ пустую файловую учебную базу, не копию рабочего каталога. В Конфигураторе задайте корню имя Учебная85. Не добавляйте эти объекты в рабочую УТ/КА2/УНФ/БП.

2. Справочники → Добавить: имя УчебныеТовары. Длина кода 10, тип кода Строка, автонумерация и контроль уникальности включены, длина наименования 100.

3. Для УчебныеТовары включите иерархию групп и элементов. Добавьте реквизиты Артикул (Строка, длина 20) и Цена (Число, 12 цифр, 2 дробных, неотрицательное). Проверка заполнения для этих учебных реквизитов не устанавливается.

4. Добавьте табличную часть Штрихкоды: Штрихкод (Строка, длина 20) и Основной (Булево). Обновите конфигурацию базы данных. Модули объектов оставьте пустыми.

5. Для этого блока УчебныеТовары не подчинён владельцу, не имеет предопределённых элементов и дополнительных обработчиков. Модули объекта/менеджера пусты, подписок и расширений нет. Иерархия групп и элементов допускает два уровня ниже корня.

6. Точную платформу 8.5.1.1343 проверяет код. Ссылки и объекты создаются самим уроком; UUID не подменяется знакомым кодом из УТ/КА2/УНФ/БП.

7. Свойства ссылки readonly, свойства полученного объекта могут быть записываемыми. Ссылка.Скопировать возвращает новый объект, но сам метод не записывает его в базу.

8. Непустой UUID/ссылка не подтверждает наличие записи. Для плановой ссылки проверяется ПолучитьОбъект=Неопределено, а данные отсутствующей записи не читаются.

9. ВерсияДанных — непрозрачная строка платформы, не число, дата, версия конфигурации или номер обновления. Урок не декодирует и не назначает её вручную.

10. Здесь в 1С примеры не запускались. Проверены исходники и установленная справка; записи/формы в ваших базах этим заполнением не создавались.

11. Весь модуль вставьте в серверный общий модуль УчебныеСсылки. Его серверная экспортная процедура ВыполнитьПример вызывается из своей процедуры формы с &НаСервереБезКонтекста. Не вставляйте готовую процедуру внутрь другого обработчика.

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

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

14. Отмена транзакции выполняется и при успехе, и при ошибке. Не заменяйте её фиксацией и не запускайте внутри транзакции вызывающего кода.

15. Откат базы не отменяет письма, HTTP-запросы и другие внешние действия обработчиков. Поэтому копия рабочей конфигурации с неизвестными обработчиками не заменяет эту подготовку.

Процедура ВыполнитьПример() Экспорт
    
    Если Метаданные.Справочники.Найти("УчебныеТовары") = Неопределено Тогда
        ВызватьИсключение "Сначала создайте учебный справочник по подготовке";
    КонецЕсли;
    Если ТранзакцияАктивна() Тогда
        ВызватьИсключение "Запустите учебную задачу вне чужой транзакции";
    КонецЕсли;
    Ссылка = Справочники.УчебныеТовары.ПолучитьСсылку(Новый УникальныйИдентификатор);
    НачатьТранзакцию();
    Попытка
        Товар = Справочники.УчебныеТовары.СоздатьЭлемент();
        Товар.УстановитьСсылкуНового(Ссылка);
        Товар.Наименование = "Учебная книга по ссылке";
        Товар.Артикул = "REF-OWN-01";
        Товар.Цена = 250;
        Товар.УстановитьНовыйКод("У");
        Товар.Записать();
        Читаемая = Товар.Ссылка;
        Сообщить(Читаемая.Код = Товар.Код);
        Сообщить(Читаемая.Наименование = "Учебная книга по ссылке");
        Сообщить(Читаемая.Ссылка = Читаемая);
        Сообщить(Читаемая.Владелец = Неопределено);
        Сообщить(Читаемая.Родитель = Справочники.УчебныеТовары.ПустаяСсылка());
        Сообщить(Не Читаемая.ЭтоГруппа);
        Сообщить(Не Читаемая.ПометкаУдаления);
        Сообщить(Не Читаемая.Предопределенный);
        Сообщить(Читаемая.ИмяПредопределенныхДанных = "");
        Сообщить(ТипЗнч(Читаемая.ВерсияДанных) = Тип("Строка"));
        Сообщить("Код и наименование — данные сохранённого товара; ссылка и владелец — не одно и то же");
        ОтменитьТранзакцию();
    Исключение
        Если ТранзакцияАктивна() Тогда
            ОтменитьТранзакцию();
        КонецЕсли;
        ВызватьИсключение;
    КонецПопытки;
    Сообщить(Не ТранзакцияАктивна());
    Сообщить(Ссылка.ПолучитьОбъект() = Неопределено);
КонецПроцедуры

Разбор по шагам

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

2. Временно записать только свой товар внутри новой транзакции.

3. Получить его настоящую ссылку, затем сравнить код/наименование с заданными значениями.

4. Различить Ссылка на сам товар, пустой Родитель и Неопределено владельца неподчинённого справочника.

5. Проверить отсутствие пометки, группы и предопределённости; прочитать тип версии, не декодировать строку.

6. Отменить транзакцию и отдельно проверить отсутствие собственной записи.

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

1. Десять проверок паспорта Истина, затем проверки отката и отсутствия собственного товара.

2. Никакому свойству Читаемая не присваивается новое значение.

3. Ссылка не является владельцем, а версия данных не объявляется номером версии конфигурации.

Ожидаемый результат

Ссылка разобрана на реальной собственной записи с итоговым откатом, а не на неизвестном входном объекте.

На что обратить внимание

1. Объект и ссылка не взаимозаменяемы: только объект используется для изменения данных, ссылка идентифицирует запись.

2. Ссылки на отсутствующий или отменённый объект не следует читать как существующий товар.

3. Никакие чужие объекты не ищутся по первому совпадению/первой строке и не удаляются по названию.

4. Свойства ссылки не присваиваются, а непрозрачная ВерсияДанных не декодируется.

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

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