ДокументСсылка.<Имя документа>.По умолчанию

Создать собственную ссылку заявки без записи документа

Пустая и плановая ссылки создаются функциональным Новый из прикладного Тип. Второй аргумент — массив с новым UUID; это ещё не запись документа.

Подготовка

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

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

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

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

5. Документы → Добавить: имя УчебнаяЗаявка, тип номера Строка, длина 9, автонумерация включена. Проведение запретите: это только учебный документ без движений.

6. Добавьте реквизит Комментарий (Строка, длина 100) и табличную часть Товары: Товар (СправочникСсылка.УчебныеТовары), Количество (Число, 9 цифр, 0 дробных, неотрицательное), Цена (Число, 12 цифр, 2 дробных, неотрицательное). Модуль документа пустой.

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

8. У своего документа и товара модули пустые, подписок, расширений и внешних обработчиков нет. История данных выключена; проведение УчебнаяЗаявка запрещено, движения/регистры не создаются.

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

10. Свойства ссылки readonly. Непустой UUID/ссылка не означает наличие записи, а ВерсияДанных — непрозрачная строка, не номер документа или версия конфигурации.

11. Примеры здесь не запускались в 1С. Только код и установленная справка 8.5.1.1343; ваши документы не создавались, не проводились и не удалялись.

12. Создайте серверный общий модуль УчебныеСсылкиДокументов и вставьте весь модуль одного урока. ВыполнитьПример() Экспорт вызывайте из своей процедуры формы с &НаСервереБезКонтекста; обновите конфигурацию БД.

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

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

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

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

1. Подготовить свою УчебнаяЗаявка в новой пустой Учебная85.

2. Создать пустую ссылку и сравнить с ПустаяСсылка менеджера.

3. Создать новый UUID, добавить его одним элементом в Массив.

4. Создать плановую ссылку, сравнить её UUID и ПолучитьСсылку.

5. Проверить отсутствие объекта; номер, дату и проведение отсутствующего документа не читать.

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

1. Семь сравнений Истина.

2. Ни товар, ни документ не записан.

3. Непустой UUID не принят за существующую заявку.

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

Конструктор ссылки документа использован на собственном новом UUID без записи.

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

1. Дата документа — его реквизит, не дата фактической записи и не гарантированный UTC. Здесь сравнивается один заданный собственный литерал.

2. Проведен и ПометкаУдаления не являются номером, правами доступа или подтверждением бизнес-корректности.

3. Скопировать возвращает новый объект, не сохранённую ссылку. Номер/дату копии не считайте гарантированно одинаковыми с исходником.

4. Только свои записи создаются внутри новой транзакции и откатываются; рабочие документы и движения не используются.

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