Вызывается перед открытием диалога получения навигационной ссылки. Если у таблицы свойство РазрешитьПолучатьНавигационнуюСсылкуТекущейСтроки имеет значение Истина, и объект/запись в текущей строке поддерживает навигационную ссылку, в параметр <СписокНавигационыхСсылок> добавляется элемент – вариант ссылки на объект/запись в текущей строке динамического списка. В обработчике можно добавить новые варианты, переставить или удалить стандартные варианты, указать ключ любого из элементов списка, в т.ч. стандартного, в качестве ключа по умолчанию. Если свойство РазрешитьПолучатьНавигационнуюСсылкуТекущейСтроки таблицы установлено в Ложь, то обработчику передается пустой <СписокНавигационыхСсылок>.
Синтаксис
ОбработкаПолученияСпискаНавигационныхСсылок(<Элемент>, <СписокНавигационыхСсылок>, <КлючПоУмолчанию>)Полное описание, параметры и ограничения
Расширение таблицы формы для динамического списка.ОбработкаПолученияСпискаНавигационныхСсылок (Form table extension for dynamic list.URLListGetProcessing)
Расширение таблицы формы для динамического списка (Form table extension for dynamic list)
ОбработкаПолученияСпискаНавигационныхСсылок (URLListGetProcessing)
Доступен, начиная с версии 8.3.21.
Синтаксис:
ОбработкаПолученияСпискаНавигационныхСсылок(<Элемент>, <СписокНавигационыхСсылок>, <КлючПоУмолчанию>)
Параметры:
<Элемент>
Тип: ТаблицаФормы.
Таблица, для которой выполняется получение списка навигационных ссылок.
<СписокНавигационыхСсылок>
Тип: СписокВыбораНавигационнойСсылки.
Если у таблицы свойство РазрешитьПолучатьНавигационнуюСсылкуТекущейСтроки имеет значение Истина, и объект/запись в текущей строке поддерживает навигационную ссылку, то в данный параметр добавляется элемент – вариант ссылки на объект/запись в текущей строке динамического списка. В обработчике можно добавить новые варианты, переставить или удалить стандартные варианты, указать ключ любого из элементов списка, в т.ч. стандартного, в качестве ключа по умолчанию.
Если у таблицы установлено свойство РазрешитьПолучатьНавигационнуюСсылкуТекущейСтроки имеет значение Ложь, то обработчику передается пустой <СписокНавигационыхСсылок>.
<КлючПоУмолчанию>
Тип: Произвольный.
В данный параметр следует поместить значение ключа из списка ссылок, соответствующего ссылке, которую требуется использовать по умолчанию.
Значение по умолчанию: Неопределено.
Описание:
Вызывается перед открытием диалога получения навигационной ссылки. Если у таблицы свойство РазрешитьПолучатьНавигационнуюСсылкуТекущейСтроки имеет значение Истина, и объект/запись в текущей строке поддерживает навигационную ссылку,
в параметр <СписокНавигационыхСсылок> добавляется элемент – вариант ссылки на объект/запись в текущей строке динамического списка. В обработчике можно добавить новые варианты, переставить или удалить стандартные варианты, указать ключ любого из элементов списка, в т.ч. стандартного, в качестве ключа по умолчанию.
Если свойство РазрешитьПолучатьНавигационнуюСсылкуТекущейСтроки таблицы установлено в Ложь, то обработчику передается пустой <СписокНавигационыхСсылок>.
Доступность:
Тонкий клиент, веб-клиент, мобильный клиент, сервер, толстый клиент, мобильное приложение (клиент), мобильное приложение (сервер), мобильный автономный сервер.
Использование в версии:
Доступен, начиная с версии 8.3.21.
Методическая информация
Практические примеры
Дополнить навигационные ссылки своей текущей строки
Источник строк и событий задан собственной формой, точными метаданными или явным константным запросом. Параметры callback приходят от платформы после настоящего действия.
Где и как запускать
Клиентские события таблицы СписокКниг собственной управляемой формы.
Подготовка
В своей учебной конфигурации создайте справочник УчебныеКарточки: код Строка 10, наименование 100, реквизит Количество Число 10.0. Вручную создайте УЧЕБ-КНИГ / Учебная книга / 3 и УЧЕБ-ТЕТР / Учебная тетрадь / 5.
В своей управляемой форме добавьте ДинамическийСписок СписокКниг, основная таблица Справочник.УчебныеКарточки. Связанная таблица СписокКниг, колонки Ссылка, Наименование и Количество; реквизит Статус Строка 200.
События назначайте таблице СписокКниг редактором. Имена и параметры обработчиков должны совпадать с редактором. Читаются только свои карточки.
Назначьте оба обработчика навигационных ссылок таблице, разрешите получение ссылки текущей строки. Выберите свою Учебная книга и откройте штатный диалог получения навигационной ссылки. Нужен не диалог ссылки всей формы.
&НаКлиенте
Процедура СписокКнигОбработкаПолученияСпискаНавигационныхСсылок(Элемент, СписокНавигационыхСсылок, КлючПоУмолчанию)
СписокНавигационыхСсылок.Добавить("СВОЯ-КНИГА", "Своя карточка текущей строки");
КлючПоУмолчанию = "СВОЯ-КНИГА";
Сообщить("Добавлен собственный вариант ссылки");
КонецПроцедурыТа же таблица: второй обработчик собственной навигационной ссылки
&НаКлиенте
Процедура СписокКнигОбработкаПолученияНавигационнойСсылки(Элемент, Ключ, Представление, НавигационнаяСсылка, СтандартнаяОбработка)
Если Ключ <> "СВОЯ-КНИГА" Тогда
Возврат;
КонецЕсли;
Данные = Элемент.ТекущиеДанные;
Если Данные = Неопределено Тогда
Возврат;
КонецЕсли;
НавигационнаяСсылка = ПолучитьНавигационнуюСсылку(Данные.Ссылка);
СтандартнаяОбработка = Ложь;
Сообщить("Ссылка получена из своей реальной текущей карточки");
КонецПроцедурыРазбор по шагам
Подготовьте свой список, колонки и конкретные строки.
Назначьте обработчик точному событию таблицы и нужной стороне клиента / сервера.
Выполните действие загрузки, выбора, настройки или получения ссылки и сравните фактический результат.
Как проверить результат
В диалоге есть Своя карточка текущей строки; для него получается настоящий адрес выбранной своей карточки.
Для стандартных ключей ранний выход сохраняет стандартную обработку. Произвольный ключ СВОЯ-КНИГА не объявляется системным перечислением.
Ожидаемый результат
Разобран конкретный callback / динамический доступ с действительным источником и без подмены типов.
На что обратить внимание
Данные порции динамического списка не являются всеми данными базы; её строки не хранятся после выхода из серверного callback.
Имена динамических свойств происходят из подготовленных колонок / путей ключа, а не создаются getter-обёрткой.
Код 1С здесь не запускался; рабочие базы и пользовательские настройки других форм не изменялись.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.