Получить и настроить описание ссылки на собственную Книгу

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

Подготовка

1. Работайте только в отдельной собственной конфигурации УчебнаяКонфигурацияСинтаксиса, не в УТ, КА, УНФ или БП. Создайте справочник УчебныеТовары с кодом типа Строка длиной 32, вручную сохраните товар Книга с кодом guide-book.

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

3. Для истории требуется право СохранениеДанныхПользователя. Права задайте вручную только в своей учебной базе; код не включает привилегированный режим и не меняет роли.

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

5. Код не удаляет товары и не проводит документы. Добавление и очистка истории — настоящая запись пользовательских данных, а не изменение локального массива. Эти BSL-образцы в 1С автоматически не выполнялись.

Процедура ВыполнитьПример() Экспорт
    Книга = Справочники.УчебныеТовары.НайтиПоКоду("guide-book");
    Если Книга.Пустая() Тогда
        ВызватьИсключение "В своей учебной базе вручную создайте Книгу с кодом guide-book";
    КонецЕсли;
    СсылкаКниги = ПолучитьНавигационнуюСсылку(Книга);
    ЗапрошенныеСсылки = Новый Массив;
    ЗапрошенныеСсылки.Добавить(СсылкаКниги);
    Представления = ПолучитьПредставленияНавигационныхСсылок(ЗапрошенныеСсылки);
    ОписаниеСсылки = Неопределено;
    Для Каждого Кандидат Из Представления Цикл
        Если Кандидат = Неопределено Тогда
            Продолжить;
        КонецЕсли;
        Если Кандидат.НавигационнаяСсылка = СсылкаКниги Тогда
            ОписаниеСсылки = Кандидат;
        КонецЕсли;
    КонецЦикла;
    Если ОписаниеСсылки = Неопределено Тогда
        ВызватьИсключение "Описание своей Книги не получено: проверьте существование товара и свои права";
    КонецЕсли;
    Сообщить(ТипЗнч(ОписаниеСсылки) = Тип("ПредставлениеНавигационнойСсылки"));
    Сообщить(ОписаниеСсылки.НавигационнаяСсылка = СсылкаКниги);
    Сообщить("Исходный текст: " + ОписаниеСсылки.Текст);
    Сообщить("Тип исходной пиктограммы: " + Строка(ТипЗнч(ОписаниеСсылки.Картинка)));
    СсылкаСписка = "e1cib/list/Справочник.УчебныеТовары";
    ОписаниеСсылки.НавигационнаяСсылка = СсылкаСписка;
    ОписаниеСсылки.Текст = "Собственный учебный список товаров";
    ОписаниеСсылки.Картинка = Новый Картинка;
    Сообщить(ОписаниеСсылки.НавигационнаяСсылка = СсылкаСписка);
    Сообщить(ОписаниеСсылки.Текст = "Собственный учебный список товаров");
    Сообщить(ТипЗнч(ОписаниеСсылки.Картинка) = Тип("Картинка"));
    Сообщить("Отображаемое представление: " + ОписаниеСсылки.Представление());
    Сообщить(Книга.Наименование = "Книга");
КонецПроцедуры

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

1. Получить платформенную ссылку на свой сохранённый товар. Передать массив строк глобальной функции.

2. Обойти возвращённые описания с защитой от Неопределено. Не угадывать порядок результатов и не создавать объект через Новый ПредставлениеНавигационнойСсылки.

3. Прочитать исходный текст и картинку. Заменить описание на свой существующий список, собственный текст и пустую картинку допустимого вида.

4. Вызвать Представление без аргументов. Вывести фактическую строку. Проверить, что наименование исходной Книги осталось прежним.

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

1. Шесть булевых проверок Истина при правильной подготовке. Наименование товара остаётся Книга.

2. Представление выводится как фактическое значение платформы. Для корректных ссылок это Текст; для некорректных предусмотрен возврат самой ссылки.

3. Изменение объекта описания не выполняет переход по ссылке и не меняет ранее сохранённую историю.

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

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

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

1. Функция может вернуть Неопределено для отсутствующего объекта; наличие текста не заменяет проверку доступа.

2. Разрешено программно задавать пустую картинку или картинку из библиотеки, не произвольное файловое изображение.

3. Не разбирайте внутреннюю ссылку как обычный HTTP URL и не открывайте ссылки из непроверенного внешнего ввода.

4. Навигационная строка не является объектной ссылкой справочника; хранение бизнес-связей требует соответствующего типа.

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