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