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