Вызывается при выборе в диалоге получения навигационной ссылки или добавления в избранное одного из вариантов ссылки, как добавленного в обработчике ОбработкаПолученияСпискаНавигационныхСсылок, так и стандартного.
Синтаксис
ОбработкаПолученияНавигационнойСсылки(<Ключ>, <Представление>, <НавигационнаяСсылка>, <СтандартнаяОбработка>)Полное описание, параметры и ограничения
ФормаКлиентскогоПриложения.ОбработкаПолученияНавигационнойСсылки (ClientApplicationForm.URLGetProcessing)
ФормаКлиентскогоПриложения (ClientApplicationForm)
ОбработкаПолученияНавигационнойСсылки (URLGetProcessing)
Доступен, начиная с версии 8.3.19.
Синтаксис:
ОбработкаПолученияНавигационнойСсылки(<Ключ>, <Представление>, <НавигационнаяСсылка>, <СтандартнаяОбработка>)
Параметры:
<Ключ>
Тип: Произвольный.
В этом параметре передается значение свойства Ключ выбранного элемента списка ссылок, полученного из обработчика ОбработкаПолученияСпискаНавигационныхСсылок. Если СписокНавигационыхСсылок, полученный из обработчика ОбработкаПолученияСпискаНавигационныхСсылок, пуст, то <Ключ> содержит значение Неопределено.
<Представление>
Тип: Строка.
Представление ссылки, полученное из обработчика ОбработкаПолученияСпискаНавигационныхСсылок или введенное пользователем. Представление может быть необходимо для формирования навигационной ссылки одним из методов глобального контекста или одного израсширений формы.
<НавигационнаяСсылка>
Тип: Строка.
Параметр, в который требуется поместить ссылку.
Полученная ссылка будет обработана (недопустимые символы будут закодированы) и в дальнейшем может быть использована для копирования в буфер или для помещения в избранное.
<СтандартнаяОбработка>
Тип: Строка.
В данный параметр передается признак выполнения стандартной (системной) обработки события.
<СтандартнаяОбработка> имеет значение Истина в одном из случаев:
если в параметре <Ключ> один из стандартных вариантов,
в параметре <Ключ> - Неопределено и <АвтоНавигационнаяСсылка> установлено в значение Ложь.
<СтандартнаяОбработка> имеет значение Ложь в одном из случаев:
если в параметре <Ключ> один из вариантов, добавленных в обработчике ОбработкаПолученияСпискаНавигационныхСсылок;
в параметре Ключ Неопределено и <АвтоНавигационнаяСсылка> имеет значение Истина.
Описание:
Вызывается при выборе в диалоге получения навигационной ссылки или добавления в избранное одного из вариантов ссылки, как добавленного в обработчике ОбработкаПолученияСпискаНавигационныхСсылок, так и стандартного.
Доступность:
Тонкий клиент, веб-клиент, мобильный клиент, сервер, толстый клиент, мобильное приложение (клиент), мобильное приложение (сервер), мобильный автономный сервер.
Использование в версии:
Доступен, начиная с версии 8.3.19.
Методическая информация
Практические примеры
Собственный вариант навигационной ссылки
Короткий пример для реального события собственной формы: источник вызова, место установки и ограничения указаны явно.
Где и как запускать
Модуль собственной управляемой формы; директива и полный заголовок обработчика включены в код.
Подготовка
Своя управляемая форма учебной обработки. Добавьте Статус Строка 250 и видимое поле. Основную процедуру назначьте одноимённому событию формы; у событий формы нет первого параметра Элемент.
Создайте собственную общую управляемую форму УчебнаяПамятка с надписью об учебных книгах. Назначьте оба обработчика событиям формы. Откройте диалог получения ссылки или добавления в избранное; выберите Памятка по книгам.
&НаКлиенте
Процедура ОбработкаПолученияСпискаНавигационныхСсылок(СписокНавигационыхСсылок, КлючПоУмолчанию)
СписокНавигационыхСсылок.Добавить("УчебнаяПамятка", "Памятка по книгам");
КлючПоУмолчанию = "УчебнаяПамятка";
КонецПроцедуры
&НаКлиенте
Процедура ОбработкаПолученияНавигационнойСсылки(Ключ, Представление, НавигационнаяСсылка, СтандартнаяОбработка)
Если Ключ = "УчебнаяПамятка" Тогда
НавигационнаяСсылка = "e1cib/app/ОбщаяФорма.УчебнаяПамятка";
СтандартнаяОбработка = Ложь;
Сообщить("Подготовлена ссылка на свою учебную памятку");
КонецЕсли;
КонецПроцедурыРазбор по шагам
Подготовьте указанную собственную форму и её реквизиты.
Назначьте процедуру точному событию в Конфигураторе.
Выполните описанное действие в своём клиенте; обработчик сам себя искусственно не вызывает.
Как проверить результат
Вариант использует собственный строковый ключ, а ссылка ведёт на реальную созданную общую форму. Для чужих стандартных ключей исходный флаг не перезаписывается.
Это внутренняя e1cib-ссылка, не внешняя сеть. Добавление варианта не создаёт форму автоматически.
Проверьте назначение процедуры в свойствах события: простое наличие одноимённого текста в модуле не является вызовом обработчика.
Ожидаемый результат
Событие имеет контекст и наблюдаемый прикладной результат, без фиктивного вызова платформы.
На что обратить внимание
Мобильные события не воспроизводятся в обычном настольном клиенте.
Статус не является подтверждением выполнения кода в 1С при сборке HTML.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.