К статье
Практический материал

Другое · 9 мин

Как получить навигационную ссылку в 1С и использовать её в формах

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

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

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

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

1. Что такое навигационная ссылка и где она применяется

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

Ссылки применяют там, где нужно сократить путь пользователя к данным: в сообщениях пользователям, в задачах и бизнес-процессах, в письмах с уведомлениями, на кнопках форм и в отчётах. Например, из уведомления о новом заказе можно сделать кликабельную ссылку, которая сразу откроет карточку документа.

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

2. Программное получение ссылки: НавигационнаяСсылка.ПолучитьСсылку

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

Параметры метода позволяют уточнить, какая именно форма должна открыться: форма объекта, форма списка или форма элемента. Если форма не указана, платформа выбирает форму по умолчанию для данного объекта. Это удобно, когда ссылка должна вести на карточку документа, а не на список всех документов.

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

Порядок получения ссылки
  1. 1
    Убедитесь, что объект доступен для чтения текущему пользователю
  2. 2
    Вызовите НавигационнаяСсылка.ПолучитьСсылку, передав объект и нужную форму
  3. 3
    Скопируйте возвращённую строку в поле сообщения, задачи или кнопку
  4. 4
    Откройте ссылку от имени целевого пользователя и проверьте отображение формы

В некоторых конфигурациях ссылка формируется не вручную, а через стандартные механизмы отправки уведомлений. В таких случаях достаточно указать объект в настройке рассылки, а платформа сама подставит навигационную ссылку в текст письма. Это снижает вероятность ошибки при составлении адреса вручную.

3. Особенности тонкого, толстого и веб-клиентов

Толстый клиент, тонкий клиент и веб-клиент работают с навигационными ссылками по-своему. Толстый клиент может использовать локальные команды запуска, тонкий — открывать формы через веб-сервер приложений, а веб-клиент — через браузер. Из-за этого одна и та же строка ссылки может вести себя по-разному в зависимости от точки входа.

Если ссылка формируется на сервере и отправляется нескольким пользователям, важно учитывать, какой клиент у каждого из них установлен по умолчанию. Ссылка, открывающаяся в толстом клиенте разработчика, может не сработать у пользователя, который работает только через браузер.

Перед внедрением ссылок в общие модули стоит определить основной режим работы базы. Если компания переходит с толстого клиента на веб-клиент, старые ссылки могут потребовать перегенерации или корректировки параметров открытия формы.

4. Куда вставлять ссылку: формы, сообщения, задачи

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

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

При вставке ссылки в печатные формы или отчёты стоит помнить, что бумажный носитель не делает ссылку активной. В электронной версии отчёта ссылка может остаться кликабельной, а после распечатки она превращается в обычный текст. Для печатных документов лучше дублировать ссылку реквизитом объекта, который пользователь сможет найти в базе вручную.

5. Проверка результата: РазобратьСсылку

После получения ссылки полезно убедиться, что она действительно указывает на нужный объект. Метод НавигационнаяСсылка.РазобратьСсылку позволяет извлечь из строки тип объекта, его ссылку и параметры формы. Если разбор завершается ошибкой или возвращает пустые значения, значит, ссылка сформирована некорректно.

Контрольные точки

Как проверить результат

Ссылка открывает целевую форму
Норма

Форма объекта открывается без ошибок

Тревожный признак

Ошибка доступа, пустая форма или сообщение о неверной ссылке

Разбор ссылки методом РазобратьСсылку
Норма

Возвращаются тип объекта и его ссылка

Тревожный признак

Пустой результат или исключение при разборе

Доступ у целевого пользователя
Норма

Пользователь с нужными правами видит объект

Тревожный признак

Пользователь получает отказ в доступе

Проверку рекомендуют проводить на нескольких пользователях с разными наборами прав. Одна и та же ссылка может открываться у администратора и выдавать отказ в доступе у обычного менеджера. Это нормальное поведение, но оно должно учитываться при проектировании уведомлений.

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

6. Ограничения, риски и типичные ошибки

Главное ограничение — привязка ссылки к конкретному клиенту и сеансу. Ссылка, полученная в веб-клиенте, может не открыться в толстом клиенте, а ссылка из одной информационной базы не будет работать в другой, даже если конфигурации идентичны. При копировании ссылок между базами нужно генерировать их заново.

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

Типичные ошибки
01
Передача ссылки на форму вместо ссылки на объект — платформа не открывает нужную карточку
02
Использование ссылки из одного клиента в другом — переход не работает или выдаёт ошибку
03
Хранение ссылок на удалённые объекты — пользователь получает сообщение об отсутствии объекта

Типичная ошибка — передача в метод ПолучитьСсылку не той ссылки на объект, например ссылки на форму вместо ссылки на сам объект. В этом случае платформа либо вернёт пустую строку, либо откроет не ту карточку. Вторая частая ошибка — попытка использовать серверный метод в контексте, где он не поддерживается, без уточнения режима вызова.

Если ссылка перестала работать, сначала проверьте, существует ли объект и есть ли у пользователя права на его просмотр. Только после этого стоит заново сгенерировать ссылку методом ПолучитьСсылку. Самостоятельная правка строки ссылки в текстовом редакторе не рекомендуется, так как легко нарушить формат, понятный платформе.

Итог

Что важно запомнить

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

Нужно ли программирование, чтобы получить навигационную ссылку?

Да, в общем случае получение ссылки требует вызова метода НавигационнаяСсылка.ПолучитьСсылку в модуле объекта или общего модуля. Некоторые типовые механизмы уведомлений могут вставлять ссылки автоматически, но для произвольных кнопок и сообщений потребуется код.

Откроется ли ссылка в веб-клиенте, если получена в толстом клиенте?

Не всегда. Навигационная ссылка привязана к типу клиента и среде выполнения, поэтому ссылка, созданная в толстом клиенте, может не сработать в веб-клиенте и наоборот. Перед массовой отправкой уточняйте, какой клиент используется у получателей.

Что делать, если по ссылке объект не открывается?

Проверьте, что объект не удалён и у пользователя есть права на его чтение. Затем убедитесь, что ссылка получена методом ПолучитьСсылку и не была изменена вручную. При необходимости сгенерируйте ссылку повторно и проверьте методом РазобратьСсылку.

Можно ли хранить навигационную ссылку в справочнике навсегда?

Не рекомендуется. Объект может быть удалён, а права пользователя изменены, тогда ссылка станет нерабочей. Лучше хранить ссылку на объект и генерировать навигационную ссылку перед использованием, либо добавлять проверку актуальности перед открытием формы.

Различается ли ссылка для формы объекта и формы списка?

Да. Метод ПолучитьСсылку позволяет указать, какую именно форму открыть: объект, список или элемент. Если форму не указать, платформа выберет форму по умолчанию, что может привести к открытию не того окна, которое ожидает пользователь.