Справка

Выдаёт первый из доступных путей до объекта на сайте. Поиск путей осуществляется с учётом настроек URL-роутинга связанных с данным типом объектов частей.

Для примера рассмотрим модуль "Статьи".
В таблице "Категории статей" в качестве подтаблиц находятся сами "Статьи", кроме этого статьи находятся и отдельно от категорий.

Запустим данный метод у произвольной статьи.
  - Вначале будет произведён поиск страницы, к которой присоединён экземпляр модуля текущей статьи (если связь обеспечена именно таким образом).
  - Затем будет найден домен, связанный с экземпляром модуля "Страницы".
  - После этого будет запрошена часть-обработчик страниц, проанализированы правила URL-распознавания, URL-префиксы и т.д.
  - Затем таким же образом будут проанализированы части отображения категорий статей и самих статей.

Из всего этого будет сформирован URL, при помощи которого будет открыт текущий объект.

Если вернуться к нашему примеру, то этот URL может иметь такой вид:
domain.net / articles_page /
category1 / articles / article1

Где articles_page - URL страницы, на которой размещён модуль со статьями.
Category1 - URL текущей категории
Articles - URL-префикс части, отвечающей за отображение статей внутри категории.
Article1 - URL текущей статьи.