Получает навигационную ссылку текущей записи регистра сведений.
Синтаксис
ПолучитьНавигационнуюСсылкуЗаписи(<ПредставлениеНавигационнойСсылки>, <ВнешниеДанныеНавигационнойСсылки>)Полное описание, параметры и ограничения
Расширение формы клиентского приложения для записи регистра сведений.ПолучитьНавигационнуюСсылкуЗаписи (Client application form extension for information register records.GetRecordURL)
Расширение формы клиентского приложения для записи регистра сведений (Client application form extension for information register records)
ПолучитьНавигационнуюСсылкуЗаписи (GetRecordURL)
Доступен, начиная с версии 8.3.19.
Синтаксис:
ПолучитьНавигационнуюСсылкуЗаписи(<ПредставлениеНавигационнойСсылки>, <ВнешниеДанныеНавигационнойСсылки>)
Параметры:
<ПредставлениеНавигационнойСсылки> (необязательный)
Тип: Строка.
Содержит представление, которое будет помещено в хранилище внешних данных навигационных ссылок.
Если данный параметр указан, а <ВнешниеДанныеНавигационнойСсылки> – нет, будет вызвано исключение.
<ВнешниеДанныеНавигационнойСсылки> (необязательный)
Тип: Структура.
Содержит значение, которое будет помещено в хранилище внешних данных навигационных ссылок. Если не указан, то внешний параметр в навигационной ссылке создаваться не будет.
Если данный параметр указан, а <ПредставлениеНавигационнойСсылки> – нет, будет вызвано исключение.
Возвращаемое значение:
Тип: Строка.
Описание:
Получает навигационную ссылку текущей записи регистра сведений.
Доступность:
Тонкий клиент, веб-клиент, мобильный клиент, сервер, толстый клиент, мобильное приложение (клиент), мобильное приложение (сервер), мобильный автономный сервер.
Использование в версии:
Доступен, начиная с версии 8.3.19.
Методическая информация
Практические примеры
ПолучитьНавигационнуюСсылкуЗаписи: форма собственной записи регистра сведений
Ссылка получена у открытой формы одной собственной сохранённой записи. Это не ссылка документа и не произвольный URL.
Где и как запускать
Основной код — модуль собственной управляемой формы записи регистра. Производитель и открытие — отдельная внешняя учебная форма.
Подготовка
В отдельной учебной конфигурации создайте независимый непериодический регистр сведений УчебныеФормыНастроек. Измерение Ключ (Строка 50), ресурс Лимит (Число 12.2), реквизит Комментарий (Строка 100). Регистратора нет.
Конструктором создайте управляемую форму записи УчебнаяЗапись с основным реквизитом Объект типа РегистрСведенийМенеджерЗаписи. Выведите Объект.Ключ, Объект.Лимит и Объект.Комментарий; ключ в опыте не меняйте.
Это форма одной записи, не форма набора записей и не обычная форма. Основной клиентский обработчик метода находится в модуле УчебнаяЗапись и назначается её собственной команде.
Внешняя учебная обработка имеет другую управляемую форму с кнопкой ОткрытьСвоюЗапись. Последние два дополнительных блока размещаются отдельно в её модуле.
Серверный производитель действительно записывает одну новую собственную запись с уникальным ключом и возвращает РегистрСведенийКлючЗаписи, созданный штатным методом. Браузер справочника этот BSL не выполняет.
В форме записи создайте команду ПоказатьСсылкуЗаписи и её кнопку; назначьте основной обработчик из примера.
&НаКлиенте
Процедура ПоказатьСсылкуЗаписи(Команда)
СсылкаНаЗапись = ЭтаФорма.ПолучитьНавигационнуюСсылкуЗаписи();
Сообщить("Навигационная ссылка текущей собственной записи:");
Сообщить(СсылкаНаЗапись);
Сообщить(Объект.Комментарий);
КонецПроцедурыВнешняя учебная форма: серверный производитель собственной записи и ключа
&НаСервереБезКонтекста
Функция СоздатьСвоюЗаписьИКлюч()
ЗначениеКлюча = "УРОК-" + Строка(Новый УникальныйИдентификатор);
Менеджер = РегистрыСведений.УчебныеФормыНастроек.СоздатьМенеджерЗаписи();
Менеджер.Ключ = ЗначениеКлюча;
Менеджер.Лимит = 25;
Менеджер.Комментарий = "Собственная учебная запись";
Менеджер.Записать();
ПоляКлюча = Новый Структура("Ключ", ЗначениеКлюча);
Возврат РегистрыСведений.УчебныеФормыНастроек.СоздатьКлючЗаписи(ПоляКлюча);
КонецФункцииВнешняя учебная форма: открыть именно свою запись по ключу
&НаКлиенте
Процедура ОткрытьСвоюЗапись(Команда)
КлючЗаписи = СоздатьСвоюЗаписьИКлюч();
ПараметрыОткрытия = Новый Структура("Ключ", КлючЗаписи);
ОткрытьФорму("РегистрСведений.УчебныеФормыНастроек.Форма.УчебнаяЗапись", ПараметрыОткрытия);
КонецПроцедурыРазбор по шагам
Серверный производитель создаёт свою запись и типизированный ключ по полям измерения.
Клиентский дополнительный код открывает точную управляемую форму с этим ключом.
Основная команда вызывается уже внутри формы записи.
Как проверить результат
Получена строка навигационной ссылки собственной записи; переход проверяйте только внутри учебной базы.
Оба необязательных параметра внешних данных ссылки здесь не переданы. Если используете их, передавайте представление и структуру вместе.
Ожидаемый результат
Метод применён к конкретной форме собственной записи, которая действительно подготовлена дополнительным кодом.
На что обратить внимание
Не заменяйте ключ записи на случайную строку или ссылку чужого объекта.
Прочитать может отменить несохранённые правки формы. Проверяйте только свою созданную запись.
Записать формы возвращает Булево. События и проверки регистра могут отменить операцию.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.