Другое · 9 мин
Как получить навигационную ссылку в 1С и использовать её в формах
Практическая инструкция: как получить навигационную ссылку в 1С, открыть объект из сообщения или задачи и проверить корректность ссылки в разных клиентах.
Навигационная ссылка в 1С — это стандартный механизм платформы, который позволяет сформировать адрес для открытия объекта, документа, справочника или формы прямо из другого места информационной базы. С её помощью пользователь может перейти из уведомления, задачи, письма или кнопки на нужную карточку, не ища её вручную в меню.
Получить такую ссылку можно программно через встроенный сервис НавигационнаяСсылка. Основной метод — ПолучитьСсылку, который принимает объект, форму и набор параметров, а возвращает строку, подходящую для вставки в поле сообщения, гиперссылку или команду. Разобрать полученную ссылку обратно помогает метод РазобратьСсылку.
Поведение ссылки зависит от типа клиента: тонкий, толстый и веб-клиент могут формировать адреса по-разному, и ссылка, созданная в одном клиенте, не всегда открывается в другом. Поэтому перед вставкой ссылки в общую рассылку или общий модуль нужно уточнить, где именно она будет использоваться.
1. Что такое навигационная ссылка и где она применяется
Навигационная ссылка не является обычной интернет-ссылкой в привычном понимании. Это внутренний идентификатор объекта в информационной базе, обёрнутый в формат, который платформа 1С умеет интерпретировать. При клике по такой ссылке система открывает соответствующую форму объекта в том клиенте, из которого была вызвана команда.
Ссылки применяют там, где нужно сократить путь пользователя к данным: в сообщениях пользователям, в задачах и бизнес-процессах, в письмах с уведомлениями, на кнопках форм и в отчётах. Например, из уведомления о новом заказе можно сделать кликабельную ссылку, которая сразу откроет карточку документа.
Важное отличие от прямого обращения к объекту через ссылку на базу данных заключается в том, что навигационная ссылка учитывает права доступа и текущий сеанс пользователя. Если у пользователя нет прав на просмотр объекта, платформа не откроет форму, даже если ссылка получена верно.
2. Программное получение ссылки: НавигационнаяСсылка.ПолучитьСсылку
Получение ссылки начинается с вызова сервера или клиентского метода, в зависимости от контекста. В типовой ситуации достаточно вызвать НавигационнаяСсылка.ПолучитьСсылку, передав ссылку на объект и, при необходимости, форму, которую следует открыть. Результат — строка, которую можно сохранить в регистр сведений, документ или передать в сообщение.
Параметры метода позволяют уточнить, какая именно форма должна открыться: форма объекта, форма списка или форма элемента. Если форма не указана, платформа выбирает форму по умолчанию для данного объекта. Это удобно, когда ссылка должна вести на карточку документа, а не на список всех документов.
После получения строки ссылку можно вставить в поле типа Строка, вывести на печатную форму или использовать в тексте сообщения. Перед массовой рассылкой рекомендуется проверить, что ссылка открывается у тестового пользователя с нужными правами.
- 1Убедитесь, что объект доступен для чтения текущему пользователю
- 2Вызовите НавигационнаяСсылка.ПолучитьСсылку, передав объект и нужную форму
- 3Скопируйте возвращённую строку в поле сообщения, задачи или кнопку
- 4Откройте ссылку от имени целевого пользователя и проверьте отображение формы
В некоторых конфигурациях ссылка формируется не вручную, а через стандартные механизмы отправки уведомлений. В таких случаях достаточно указать объект в настройке рассылки, а платформа сама подставит навигационную ссылку в текст письма. Это снижает вероятность ошибки при составлении адреса вручную.
3. Особенности тонкого, толстого и веб-клиентов
Толстый клиент, тонкий клиент и веб-клиент работают с навигационными ссылками по-своему. Толстый клиент может использовать локальные команды запуска, тонкий — открывать формы через веб-сервер приложений, а веб-клиент — через браузер. Из-за этого одна и та же строка ссылки может вести себя по-разному в зависимости от точки входа.
Если ссылка формируется на сервере и отправляется нескольким пользователям, важно учитывать, какой клиент у каждого из них установлен по умолчанию. Ссылка, открывающаяся в толстом клиенте разработчика, может не сработать у пользователя, который работает только через браузер.
Перед внедрением ссылок в общие модули стоит определить основной режим работы базы. Если компания переходит с толстого клиента на веб-клиент, старые ссылки могут потребовать перегенерации или корректировки параметров открытия формы.
4. Куда вставлять ссылку: формы, сообщения, задачи
На кнопке формы ссылку удобно хранить в реквизите типа Строка и обрабатывать в событии ПриНажатии. Пользователь нажимает кнопку, и система открывает целевой объект. Такой подход подходит для переходов между связанными документами, например от заказа к отгрузке или от контрагента к договору.
В сообщениях и задачах ссылка вставляется в текст уведомления. Получатель видит кликабельный фрагмент и переходит к объекту напрямую. Это особенно полезно в процессах согласования, когда инициатору нужно быстро проверить результат действий исполнителя.
При вставке ссылки в печатные формы или отчёты стоит помнить, что бумажный носитель не делает ссылку активной. В электронной версии отчёта ссылка может остаться кликабельной, а после распечатки она превращается в обычный текст. Для печатных документов лучше дублировать ссылку реквизитом объекта, который пользователь сможет найти в базе вручную.
5. Проверка результата: РазобратьСсылку
После получения ссылки полезно убедиться, что она действительно указывает на нужный объект. Метод НавигационнаяСсылка.РазобратьСсылку позволяет извлечь из строки тип объекта, его ссылку и параметры формы. Если разбор завершается ошибкой или возвращает пустые значения, значит, ссылка сформирована некорректно.
Как проверить результат
Форма объекта открывается без ошибок
Ошибка доступа, пустая форма или сообщение о неверной ссылке
Возвращаются тип объекта и его ссылка
Пустой результат или исключение при разборе
Пользователь с нужными правами видит объект
Пользователь получает отказ в доступе
Проверку рекомендуют проводить на нескольких пользователях с разными наборами прав. Одна и та же ссылка может открываться у администратора и выдавать отказ в доступе у обычного менеджера. Это нормальное поведение, но оно должно учитываться при проектировании уведомлений.
Признаком рабочей ссылки является открытие ожидаемой формы без сообщений об ошибке и без запроса повторной авторизации. Если форма открывается, но объект не совпадает с тем, который передавался в метод, скорее всего, в параметры попала неверная ссылка или объект был удалён после генерации ссылки.
6. Ограничения, риски и типичные ошибки
Главное ограничение — привязка ссылки к конкретному клиенту и сеансу. Ссылка, полученная в веб-клиенте, может не открыться в толстом клиенте, а ссылка из одной информационной базы не будет работать в другой, даже если конфигурации идентичны. При копировании ссылок между базами нужно генерировать их заново.
Удаление объекта после создания ссылки делает её нерабочей. Пользователь переходит по ссылке и получает сообщение, что объект не найден. Поэтому ссылки не стоит хранить навсегда в справочниках без механизма проверки актуальности объекта.
Типичная ошибка — передача в метод ПолучитьСсылку не той ссылки на объект, например ссылки на форму вместо ссылки на сам объект. В этом случае платформа либо вернёт пустую строку, либо откроет не ту карточку. Вторая частая ошибка — попытка использовать серверный метод в контексте, где он не поддерживается, без уточнения режима вызова.
Если ссылка перестала работать, сначала проверьте, существует ли объект и есть ли у пользователя права на его просмотр. Только после этого стоит заново сгенерировать ссылку методом ПолучитьСсылку. Самостоятельная правка строки ссылки в текстовом редакторе не рекомендуется, так как легко нарушить формат, понятный платформе.
Что важно запомнить
Навигационную ссылку получают через НавигационнаяСсылка.ПолучитьСсылку, проверяют разбором и открывают от имени целевого пользователя с учётом типа клиента и прав доступа.
Нужно ли программирование, чтобы получить навигационную ссылку?
Да, в общем случае получение ссылки требует вызова метода НавигационнаяСсылка.ПолучитьСсылку в модуле объекта или общего модуля. Некоторые типовые механизмы уведомлений могут вставлять ссылки автоматически, но для произвольных кнопок и сообщений потребуется код.
Откроется ли ссылка в веб-клиенте, если получена в толстом клиенте?
Не всегда. Навигационная ссылка привязана к типу клиента и среде выполнения, поэтому ссылка, созданная в толстом клиенте, может не сработать в веб-клиенте и наоборот. Перед массовой отправкой уточняйте, какой клиент используется у получателей.
Что делать, если по ссылке объект не открывается?
Проверьте, что объект не удалён и у пользователя есть права на его чтение. Затем убедитесь, что ссылка получена методом ПолучитьСсылку и не была изменена вручную. При необходимости сгенерируйте ссылку повторно и проверьте методом РазобратьСсылку.
Можно ли хранить навигационную ссылку в справочнике навсегда?
Не рекомендуется. Объект может быть удалён, а права пользователя изменены, тогда ссылка станет нерабочей. Лучше хранить ссылку на объект и генерировать навигационную ссылку перед использованием, либо добавлять проверку актуальности перед открытием формы.
Различается ли ссылка для формы объекта и формы списка?
Да. Метод ПолучитьСсылку позволяет указать, какую именно форму открыть: объект, список или элемент. Если форму не указать, платформа выберет форму по умолчанию, что может привести к открытию не того окна, которое ожидает пользователь.