В экосистеме 1С:Предприятие необходимость пересылать пользователей на конкретные формы объектов встречается повсеместно. Будь то создание отчета с гиперссылками, формирование писем контрагентам или организация внутреннего документооборота через мессенджеры. Разработчики часто сталкиваются с задачей, как программно сформировать строку, которая откроет нужный документ или справочник при клике.
Существует унифицированный механизм для решения этой проблемы, работающий в большинстве современных версий платформы. Правильное использование этого инструмента позволяет избежать ошибок при передаче параметров и гарантирует, что ссылка будет валидной как в файловом, так и в клиент-серверном варианте работы. Однако, нюансы реализации зависят от типа клиента и версии конфигуратора.
Данная статья подробно разбирает метод ПолучитьНавигационнуюСсылку, доступный в объекте СправочникСсылка. Мы рассмотрим тонкости формирования строки для запуска в толстом клиенте, тонком клиенте и веб-клиенте. Также затронем вопросы безопасности и особенности обработки исключительных ситуаций при генерации ссылок.
Основной метод получения ссылки в коде
Для формирования строки навигации в платформе 1С:Предприятие 8.3 и выше используется встроенный метод ПолучитьНавигационнуюСсылку. Он вызывается непосредственно у объекта ссылки, будь то справочник, документ или план счетов. Результатом работы метода является строка, содержащая полный адрес объекта с учетом текущего сеанса.
Синтаксис вызова предельно прост и не требует подключения внешних библиотек. Вам достаточно иметь ссылку на объект в переменной. Метод автоматически определит тип соединения и сформирует корректный протокол запуска. Это избавляет разработчика от необходимости вручную конструировать сложные строки подключения.
Важно понимать, что возвращаемая строка может содержать специальные символы, требующие экранирования при вставке в HTML или текстовые поля. В коде 1С это обрабатывается автоматически, но при выводе в интерфейсе могут потребоваться дополнительные преобразования форматов.
СсылкаНаСправочник = Справочники.Номенклатура.НайтиПоНаименованию("Товар А");
ТекстСсылки = СсылкаНаСправочник.ПолучитьНавигационнуюСсылку();
Стоит отметить, что данный метод работает только на стороне сервера или в толстом клиенте. Попытка вызвать его напрямую из модуля формы в тонком клиенте без соответствующих директив приведет к ошибке выполнения. Всегда проверяйте контекст выполнения вашего кода перед обращением к серверным методам.
Для проверки работоспособности ссылки скопируйте полученную строку в буфер обмена и вставьте в адресную строку браузера (для веб-клиента) или запустите через консоль запуска 1С.
Особенности работы в тонком и веб-клиенте
Современные интерфейсы Такси и веб-клиент накладывают определенные ограничения на прямой запуск внешних ссылок. Браузеры блокируют попытки запуска локальных приложений через протокол v8 из соображений безопасности. Поэтому сформированная ссылка может вести себя по-разному в зависимости от среды выполнения.
В веб-клиенте ссылка, полученная через ПолучитьНавигационнуюСсылку, часто содержит параметры сессии. Если вы отправите такую ссылку другому пользователю, она может не сработать, так как его идентификатор сессии будет отличаться. Для общих ссылок необходимо использовать режим публикации без привязки к конкретной сессии.
При работе в тонком клиенте ссылка срабатывает корректно, запуская нужный экземпляр 1С:Предприятие. Однако, если у пользователя установлены разные версии платформы, могут возникнуть конфликты версий метаданных. Система попытается обновить конфигуратор или выдаст предупреждение о несоответствии.
⚠️ Внимание: Прямая передача ссылок с параметрами сессии (
SessionID) другим пользователям приведет к ошибке доступа. Для массовой рассылки используйте ссылки без привязки к сеансу или механизмы публикации на веб-сервере.
Если ваша задача — открыть форму в уже запущенном сеансе, стандартная навигационная ссылка может открыть новое окно. Это не всегда удобно для пользователей. В таких случаях лучше использовать внутреннюю навигацию через команду интерфейса или обработку событий формы, а не внешние ссылки.
Формирование ссылок для отчетов и печатных форм
Частая задача разработчика — сделать отчет интерактивным. Пользователь должен иметь возможность кликнуть на строку с номенклатурой и сразу перейти к карточке товара. Для этого в макетах таблиц или схем компоновки данных используются поля, содержащие навигационные ссылки.
При формировании данных отчета на сервере вы можете заранее рассчитать ссылки для каждой строки результата. Это повышает производительность, так как метод вызывается один раз при формировании набора данных, а не при каждом клике пользователя. Однако это увеличивает объем передаваемых данных.
В макетах компоновки данных (СКД) можно настроить поле как "Поле гиперссылки". В свойствах поля указывается выражение, вызывающее метод получения ссылки. Это позволяет динамически генерировать адрес в зависимости от текущей записи набора данных.
| Тип объекта | Метод получения | Особенности |
|---|---|---|
| Справочник | Ссылка.ПолучитьНавигационнуюСсылку() |
Работает стабильно во всех режимах |
| Документ | Ссылка.ПолучитьНавигационнуюСсылку() |
Может требовать прав на чтение |
| План счетов | Ссылка.ПолучитьНавигационнуюСсылку() |
Специфично для бухгалтерских конфигураций |
| Константа | Константы.Имя.ПолучитьНавигационнуюСсылку() |
Открывает форму значения константы |
Не забывайте проверять права доступа. Если пользователь не имеет прав на просмотр объекта, ссылка может быть сформирована, но при переходе система выдаст сообщение об ошибке прав доступа. Логика отчета должна учитывать это, скрывая ссылки для недоступных объектов.
☑️ Проверка ссылки в отчете
Обработка исключений и валидация ссылок
Хотя метод ПолучитьНавигационнуюСсылку надежен, существуют ситуации, когда он может вернуть пустую строку или вызвать исключение. Например, если объект ссылки еще не записан в базу данных (имеет пустой UUID), система не сможет сформировать уникальный адрес.
Перед вызовом метода рекомендуется проверять свойство Пустая() у ссылки. Это простая, но эффективная мера предосторожности, которая спасет ваш код от аварийного завершения в runtime. Обработка таких ситуаций должна быть встроена в логику формирования данных.
Если Не СсылкаНаОбъект.Пустая() Тогда
ТекстСсылки = СсылкаНаОбъект.ПолучитьНавигационнуюСсылку();
Иначе
ТекстСсылки = "";
КонецЕсли;
Также стоит учитывать ограничения на длину строки в некоторых полях базы данных или форматах выгрузки (например, старые версии Excel). Навигационная ссылка может быть довольно длинной, особенно в распределенных информационных базах. При необходимости можно использовать сервисы сокращения ссылок, хотя это добавляет лишнее звено в цепочку открытия.
Что делать, если ссылка не открывается?
Если ссылка не срабатывает, проверьте, установлен ли клиент 1С на машине пользователя. Для веб-клиента убедитесь, что URL публикации доступен из внешней сети и не блокируется фаерволом.
Альтернативные способы навигации и запуск форм
Иногда использование навигационной ссылки является избыточным. Если вы разрабатываете расширение конфигурации или работаете внутри одной базы, проще использовать объект ПараметрыСеанса или команду интерфейса. Это позволяет открывать формы в том же окне, сохраняя контекст работы пользователя.
Для открытия формы из кода используется метод ОткрытьФорму. Он принимает строку имени формы или объект формы. Этот способ более гибок, так как позволяет передать дополнительные параметры открытия, такие как режим блокировки или начальные значения полей.
Однако, метод ОткрытьФорму работает только в текущем сеансе. Вы не можете передать результат его работы другому пользователю по email. Поэтому выбор между навигационной ссылкой и прямым открытием формы зависит от сценария использования: внешняя коммуникация или внутренняя логика приложения.
⚠️ Внимание: При обновлении платформы 1С синтаксис навигационных ссылок может измениться. Ссылки, сформированные в старых версиях (до 8.3.10), могут быть несовместимы с новыми версиями клиентов. Всегда тестируйте ссылки после миграции.
В мобильных приложениях 1С поддержка навигационных ссылок ограничена. Ссылки вида v8:// не будут обработаны мобильным клиентом корректно. Для мобильных решений следует использовать встроенные механизмы навигации мобильного платформы или специальные обработчики URI.
Навигационная ссылка идеальна для внешних сценариев (email, мессенджеры), а метод ОткрытьФорму лучше подходит для внутренней логики интерфейса.
Практические примеры использования в конфигурациях
Рассмотрим реальный кейс: автоматическая рассылка уведомлений менеджерам о новых заказах. В теле письма формируется таблица со списком заказов. Каждая ячейка с номером заказа должна быть активной ссылкой.
В цикле формирования письма вы перебираете список новых документов. Для каждого документа вызывается метод получения ссылки. Полученная строка вставляется в HTML-тело письма как атрибут href тега <a>. Менеджер получает письмо, кликает на номер и сразу видит карточку заказа.
Другой пример — интеграция с CRM-системой. При создании лида в CRM система должна создать задачу в 1С и предоставить ссылку на нее. Используя HTTP-сервисы 1С, вы можете сгенерировать ссылку на стороне сервера и вернуть её в ответе JSON для CRM.
- 📧 Email-рассылки: Вставка ссылок в шаблон письма для быстрого перехода к объектам.
- 💬 Чат-боты: Отправка ссылок в Telegram или WhatsApp для оперативного согласования документов.
- 🌐 Веб-порталы: Размещение ссылок на корпоративном портале для доступа сотрудников к базам 1С.
Важно помнить о безопасности. Не стоит генерировать ссылки на конфиденциальные документы и отправлять их по открытым каналам связи без дополнительной авторизации. Злоумышленник, перехвативший ссылку, может получить доступ к данным, если не настроены права доступа на уровне записей (RLS).
Можно ли получить ссылку на невыгруженный объект в распределенной базе?
Да, метод ПолучитьНавигационнуюСсылку вернет ссылку с идентификатором узла распределенной базы. Однако, если вы попытаетесь открыть эту ссылку в узле, где объект еще не получен, система выдаст ошибку или предложит выполнить обмен данными.
Как сократить длину навигационной ссылки?
Стандартными средствами 1С сократить ссылку нельзя. Можно использовать внешние сервисы сокращения URL (bit.ly и аналоги), но это добавляет зависимость от стороннего ресурса. Внутри корпоративной сети лучше использовать короткие алиасы через веб-сервер.
Работает ли ссылка, если пользователь не авторизован в 1С?
При переходе по ссылке система потребует авторизации. Если используется веб-клиент, откроется форма входа. Если толстый клиент — диалог выбора базы и ввода логина. Ссылка сама по себе не содержит пароля.
Почему ссылка открывается в новом окне браузера?
Это стандартное поведение браузера для внешних ссылок. Изменить это можно только через настройки браузера пользователя или используя JavaScript на странице-посреднике, если ссылка вставлена в веб-интерфейс.