Как создать ссылку на документ в 1С

Ссылка на документ в 1С нужна в двух типовых ситуациях: когда пользователь хочет поделиться конкретным документом с коллегой (например, отправить в письме или мессенджере) и когда разработчик встраивает переход к документу в отчет, печатную форму или обработку. В обоих случаях используется навигационная ссылка — специальный адрес вида e1cib/data/Документ.РеализацияТоваровУслуг?ref=..., который открывает документ прямо в клиенте 1С.

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

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

Что такое навигационная ссылка и когда она нужна

Навигационная ссылка — это текстовый идентификатор объекта базы: документа, элемента справочника, записи регистра. Платформа 1С формирует её автоматически для каждого объекта. Ссылка содержит тип объекта (например, Документ.ЗаказПокупателя) и уникальный внутренний идентификатор (GUID), поэтому она однозначно указывает на конкретный документ независимо от его номера и даты.

Практические сценарии, где ссылка незаменима: бухгалтер просит проверить конкретную накладную и отправляет ссылку вместо долгих объяснений «документ от 15 числа, контрагент такой-то»; менеджер вставляет ссылку на счет в письмо клиенту или коллеге; руководитель в задаче ставит ссылку на документ-основание. Во всех случаях получатель нажимает на ссылку — и документ открывается у него в 1С.

Как получить ссылку на документ через интерфейс

Самый простой способ не требует никаких навыков программирования. Откройте нужный документ, нажмите кнопку «Ещё» в командной панели формы и выберите пункт «Получить ссылку…». В появившемся окне платформа покажет навигационную ссылку — нажмите «Копировать», и она попадет в буфер обмена. Дальше ссылку можно вставить в письмо, сообщение или задачу.

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

1. 1
   Откройте нужный документ в 1С
2. 2
   Нажмите «Ещё» в командной панели формы
3. 3
   Выберите «Получить ссылку…»
4. 4
   В окне нажмите «Копировать»
5. 5
   Вставьте ссылку в письмо, чат или задачу
6. 6
   Попросите получателя проверить, что документ открывается

Проверить результат просто: вставьте ссылку в любое поле ввода 1С, которое поддерживает переход (например, в строку «Перейти по ссылке» в меню «Файл» или через команду «Перейти по ссылке» в разделе «Сервис»), либо отправьте коллеге и убедитесь, что документ открылся у него.

Как программно создать ссылку на документ

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

// ДокСсылка — значение типа ДокументСсылка.РеализацияТоваровУслуг
НавСсылка = ПолучитьНавигационнуюСсылку(ДокСсылка);
// Результат: e1cib/data/Документ.РеализацияТоваровУслуг?ref=a94b...

Если нужно открыть документ из кода без ссылки, используйте метод ПоказатьЗначение(, ДокСсылка) на клиенте — платформа сама откроет форму объекта. Навигационная ссылка нужна именно тогда, когда адрес документа передается как текст: в письме, отчете, внешней системе или журнале событий.

НавСсылка = ПолучитьНавигационнуюСсылку(ДокСсылка);
Сообщить(НавСсылка); // e1cib/data/Документ.ЗаказПокупателя?ref=...

Ссылка на новый документ с заполнением

Отдельный сценарий — ссылка, которая открывает форму создания нового документа с предзаполненными реквизитами. Для этого в ПолучитьНавигационнуюСсылку() вторым параметром передают структуру значений заполнения. Такой прием используют, например, чтобы из письма сразу создать заказ на основании конкретного счета.

Как вставить ссылку в письмо, отчет или печатную форму

В письмах, отправляемых из 1С (например, при рассылке счетов из типовых конфигураций), навигационную ссылку можно добавить в текст вручную — получатель, работающий в той же базе, кликнет по ней и откроет документ. Учтите: внешний контрагент без доступа к вашей базе по такой ссылке ничего не откроет, поэтому клиентам ссылку отправлять бессмысленно.

В отчетах на СКД ссылки на документы работают «из коробки»: если в отчет выведено поле-ссылка (например, «Документ» или «Заказ»), двойной щелчок по ячейке открывает объект. Дополнительно настраивать ничего не нужно — платформа сама обрабатывает расшифровку. Если вместо открытия объекта отчет показывает меню расшифровки, выберите в нем пункт «Открыть».

В печатных формах, формируемых в табличный документ, ссылку можно задать через параметр расшифровки ячейки: в свойство «Расшифровка» помещают ссылку на объект, и при интерактивном просмотре (не на бумаге) клик по ячейке откроет документ. Это удобно для внутренних сводных форм, которые смотрят на экране.

Проверка результата и типичные ошибки

После создания ссылки убедитесь, что она ведет именно на нужный документ. Скопируйте её и выполните переход через команду «Перейти по ссылке» (обычно доступна в главном меню или через сочетание в поле навигации). Должна открыться форма того самого документа с правильными номером, датой и контрагентом.

Отдельно стоит ограничение при обмене между базами. Если документ синхронизируется между двумя базами (например, БП и УТ), навигационные ссылки в каждой базе свои. Чтобы из одной базы открыть документ в другой, нужен либо механизм перехода по соответствию ссылок в настройках синхронизации, либо ручной поиск по номеру и дате.

FAQ