Глобальный контекст.ПолучитьНавигационнуюСсылку (Global context.GetURL)

Глобальный контекст (Global context)

ПолучитьНавигационнуюСсылку (GetURL)

Доступен, начиная с версии 8.2.

Вариант синтаксиса: Ссылка с параметрами на объект данных по ссылке базы данных или на запись регистра сведений

Синтаксис:

ПолучитьНавигационнуюСсылку(<Объект>, <ПредставлениеНавигационнойСсылки>, <ВнешниеДанныеНавигационнойСсылки>)

Параметры:

<Объект> (обязательный)

Тип: Произвольный.
Ссылка на объект метаданных или
РегистрСведенийКлючЗаписи.<Имя регистра сведений>.

Содержит объект, для которого получается навигационная ссылка.

<ПредставлениеНавигационнойСсылки> (обязательный)

Тип: Строка.
Содержит представление, которое будет помещено в хранилище внешних данных навигационных ссылок.

<ВнешниеДанныеНавигационнойСсылки> (обязательный)

Тип: Структура.
Содержит значение, которое будет помещено в хранилище внешних данных навигационных ссылок.

Описание варианта метода:

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

Доступность: толстый клиент, тонкий клиент, веб-клиент, сервер.

Вариант синтаксиса: Ссылка на объект

Синтаксис:

ПолучитьНавигационнуюСсылку(<Объект>, <ИмяРеквизита>, <Индекс>)

Параметры:

<Объект> (необязательный)

Тип: Любая ссылка, РегистрСведенийКлючЗаписи.<Имя регистра сведений>, ИдентификаторОбсужденияСистемыВзаимодействия, ОбсуждениеСистемыВзаимодействия, ИдентификаторСообщенияСистемыВзаимодействия, СообщениеСистемыВзаимодействия.
В качестве значения данного параметра могут быть указаны:

Ссылка на объект информационной базы,
Ключ записи регистра сведений,
Идентификатор обсуждения системы взаимодействия,
Обсуждение системы взаимодействия,
Идентификатор сообщения системы взаимодействия,
Сообщение системы взаимодействия.

Если в данном параметре передано значение, от которого нельзя получить навигационную ссылку, будет сгенерировано исключение о неверном значении параметра.

<ИмяРеквизита> (необязательный)

Тип: Строка.
Если требуется получить навигационную ссылку на реквизит объекта, то в данном параметре следует указать имя реквизита.
Если требуется получить ссылку на ключ записи регистра сведений, то данный параметр должен содержать имя ресурса регистра сведений.
Если требуется получить ссылку на реквизит табличной части, то он указывается через точку "." после имени табличной части, и в параметре <Индекс> следует указать индекс строки табличной части.

<Индекс> (необязательный)

Тип: Число.
Индекс строки в табличной части, если требуется получить навигационную ссылку на реквизит табличной части.
Первая строка имеет индекс, равный 0.

Описание варианта метода:

Выполняет обращение к серверу только при получении ссылки на реквизит. При получении ссылки на объект информационной базы или обсуждение системы взаимодействия запрос на сервер не выполняется.

Вариант синтаксиса: Ссылка на отчет целиком

Синтаксис:

ПолучитьНавигационнуюСсылку(<Отчет>, <ПредставлениеНавигационнойСсылки>, <ВнешниеДанныеНавигационнойСсылки>)

Параметры:

<Отчет> (обязательный)

Тип: ОбъектМетаданных: Отчет.
Содержит отчет, для которого получается навигационная ссылка.

<ПредставлениеНавигационнойСсылки> (необязательный)

Тип: Строка.
Содержит представление, которое будет помещено в хранилище внешних данных навигационных ссылок. Если этот параметр указан, а <ВнешниеДанныеНавигационнойСсылки> – нет, будет вызвано исключение.

<ВнешниеДанныеНавигационнойСсылки> (необязательный)

Тип: Структура.
Содержит значение, которое будет помещено в хранилище внешних данных навигационных ссылок. Если не указан, то внешний параметр в навигационной ссылке создаваться не будет. Если этот параметр указан, а <ПредставлениеНавигационнойСсылки> – нет, будет вызвано исключение.

Описание варианта метода:

Доступен только на сервере.

Вариант синтаксиса: Ссылка на вариант отчета

Синтаксис:

ПолучитьНавигационнуюСсылку(<Отчет>, <Вариант>, <ПредставлениеНавигационнойСсылки>, <ВнешниеДанныеНавигационнойСсылки>)

Параметры:

<Отчет> (обязательный)

Тип: ОбъектМетаданных: Отчет.
Содержит отчет, для которого получается навигационная ссылка.

<Вариант> (обязательный)

Тип: Строка.
Содержит ключ варианта отчета.

<ПредставлениеНавигационнойСсылки> (необязательный)

Тип: Строка.
Содержит представление, которое будет помещено в хранилище внешних данных навигационных ссылок.
Если данный параметр указан, а <ВнешниеДанныеНавигационнойСсылки> – нет, будет вызвано исключение.

<ВнешниеДанныеНавигационнойСсылки> (необязательный)

Тип: Структура.
Содержит значение, которое будет помещено в хранилище внешних данных навигационных ссылок. Если не указан, то внешний параметр в навигационной ссылке создаваться не будет. Если данный параметр указан, а <ПредставлениеНавигационнойСсылки> – нет, будет вызвано исключение.

Описание варианта метода:

Доступен только на сервере.

Вариант синтаксиса: Ссылка на отчет с полными настройками

Синтаксис:

ПолучитьНавигационнуюСсылку(<Отчет>, <Настройки>, <ПредставлениеНавигационнойСсылки>, <ВнешниеДанныеНавигационнойСсылки>)

Параметры:

<Отчет> (обязательный)

Тип: ОбъектМетаданных: Отчет.
Содержит отчет, для которого получается навигационная ссылка.

<Настройки> (обязательный)

Тип: НастройкиКомпоновкиДанных.
Содержит полные настройки отчета.

<ПредставлениеНавигационнойСсылки> (обязательный)

Тип: Строка.
Содержит представление, которое будет помещено в хранилище внешних данных навигационных ссылок, как для объекта настроек, так и для объекта внешних данных, если он задан.

<ВнешниеДанныеНавигационнойСсылки> (необязательный)

Описание варианта метода:

Доступен только на сервере.

Вариант синтаксиса: Ссылка на обработку

Синтаксис:

ПолучитьНавигационнуюСсылку(<Обработка>, <ПредставлениеНавигационнойСсылки>, <ВнешниеДанныеНавигационнойСсылки>)

Параметры:

<Обработка> (обязательный)

Тип: ОбъектМетаданных: Обработка.
Содержит обработку, для которой получается навигационная ссылка.

<ПредставлениеНавигационнойСсылки> (необязательный)

<ВнешниеДанныеНавигационнойСсылки> (необязательный)

Тип: Структура.
Содержит значение, которое будет помещено в хранилище внешних данных навигационных ссылок. Если не указан, то внешний параметр в навигационной ссылке создаваться не будет.
Если данный параметр указан, а <ПредставлениеНавигационнойСсылки> – нет, будет вызвано исключение.

Описание варианта метода:

Доступен только на сервере.

Вариант синтаксиса: Ссылка на списки

Синтаксис:

Параметры:

<Объект> (обязательный)

Тип: Произвольный.
ОбъектМетаданных: Справочник, ОбъектМетаданных: Документ, ОбъектМетаданных: РегистрНакопления и другие объекты, для которых возможно создание формы списка.

Содержит объект, для списка которого получается навигационная ссылка.

<ПредставлениеНавигационнойСсылки> (необязательный)

<ВнешниеДанныеНавигационнойСсылки> (необязательный)

Тип: Структура.
Содержит значение, которое будет помещено в хранилище внешних данных навигационных ссылок. Если не указан, то внешний параметр в навигационной ссылке создаваться не будет.
Если данный параметр указан, а <ПредставлениеНавигационнойСсылки> – нет, будет вызвано исключение.

Описание варианта метода:

Доступен только на сервере.

Вариант синтаксиса: Ссылка на списки с заданными настройками

Синтаксис:

ПолучитьНавигационнуюСсылку(<Объект>, <Настройки>, <ПредставлениеНавигационнойСсылки>, <ВнешниеДанныеНавигационнойСсылки>)

Параметры:

<Объект> (обязательный)

<Настройки> (обязательный)

Тип: НастройкиТаблицыДинамическогоСписка.
Содержит настройки таблицы динамического списка.

<ПредставлениеНавигационнойСсылки> (обязательный)

Тип: Строка.
Содержит представление ссылки, которое будет помещено в хранилище внешних данных навигационных ссылок, как для объекта настроек, так и для объекта внешних данных, если они заданы.

<ВнешниеДанныеНавигационнойСсылки> (необязательный)

Описание варианта метода:

Доступен только на сервере.

Вариант синтаксиса: Ссылка для команд

Синтаксис:

ПолучитьНавигационнуюСсылку(<Команда>, <Параметр>, <ПредставлениеНавигационнойСсылки>, <ВнешниеДанныеНавигационнойСсылки>)

Параметры:

<Команда> (обязательный)

Тип: ОбъектМетаданных: ОбщаяКоманда, ОбъектМетаданных: Команда.
Содержит команду, для которой получается навигационная ссылка.

<Параметр> (необязательный)

Тип: Произвольный.
Содержит значение параметра, который нужно передать команде.
Исключение вызывается в случаях:

если у команды тип параметра не задан,
если тип параметра не совпадает с типом переданного параметра, бросается исключение.

<ПредставлениеНавигационнойСсылки> (необязательный)

<ВнешниеДанныеНавигационнойСсылки> (необязательный)

Тип: Структура.
Содержит значение, которое будет помещено в хранилище внешних данных навигационных ссылок. Если не указан, то внешний параметр в навигационной ссылке создаваться не будет.
Если данный параметр указан, а <ПредставлениеНавигационнойСсылки> – нет, будет вызвано исключение.

Описание варианта метода:

Доступен только на сервере.

Возвращаемое значение:

Тип: Строка.

Описание:

Получает навигационную ссылку в формате 1С:Предприятия на объект информационной базы, на его реквизит, на обсуждение или сообщение системы взаимодействия.

Доступность:

Тонкий клиент, веб-клиент, мобильный клиент, сервер, толстый клиент, внешнее соединение, мобильное приложение (клиент), мобильное приложение (сервер), мобильный автономный сервер.

Примечание:

Пример:

// Адрес объекта

Адрес1 = ПолучитьНавигационнуюСсылку(Объект.Ссылка);
// Адрес реквизита объекта

Адрес2 = ПолучитьНавигационнуюСсылку(Объект.Ссылка, "Реквизит1");
// Адрес реквизита табличной части объекта

Адрес3 = ПолучитьНавигационнуюСсылку(Объект.Ссылка,
"ТабличнаяЧасть1.Реквизит1", 10);

См. также:

Глобальный контекст, метод ПоказатьОповещениеПользователя
ПредставлениеНавигационнойСсылки, свойство НавигационнаяСсылка

Использование в версии:

Доступен, начиная с версии 8.2.

Методическая информация