К статье
Практический материал

Другое · 7 мин

Как получить ссылку на документ в 1С через тип ДокументСсылка

Как получить ссылку на документ в 1С: тип ДокументСсылка, способы в форме и модуле, отличие ссылки от строки и веб-адреса, проверка и ошибки.

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

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

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

Что означает тип ДокументСсылка

ДокументСсылка относится к ссылочным типам и привязана к конкретному документу в текущей информационной базе. Каждый документ имеет свой уникальный идентификатор в рамках базы, поэтому ссылка позволяет однозначно найти нужный экземпляр по номеру, дате или внутреннему идентификатору.

Важно понимать, что ссылка сама по себе не отображается пользователю как гиперссылка в браузере. В обычном приложении она используется внутри конфигурации, а в веб-клиенте открытие документа по ссылке зависит от механизмов платформы и настроек публикации. Нельзя просто скопировать значение ссылки в адресную строку и ожидать открытия документа.

Как получить ссылку в модуле объекта и формы

В модуле объекта документа ссылку на текущий документ обычно можно получить через свойство Объект.Ссылка. Это подходит, когда код выполняется уже в контексте открытого документа и нужно передать ссылку в другую процедуру, регистр или отчёт.

В модуле формы ссылку можно взять из атрибута формы, связанного с документом, или из текущих данных формы списка. Например, в форме списка часто используется выражение вида ТекущиеДанные.Ссылка, а в форме объекта — Объект.Ссылка. Точное имя атрибута зависит от конфигурации.

Если нужно получить ссылку программно по номеру и дате, применяется менеджер документа. Общий подход заключается в обращении к менеджеру нужного документа и запросе ссылки по реквизитам, определяющим документ однозначно. Результат следует проверять на отсутствие значения перед дальнейшим использованием.

Получение ссылки из списка и отчёта

В форме списка документов выделенная строка содержит ссылку на выбранный документ. Чтобы получить её в коде, обращаются к текущим данным выбранной строки. Это удобно для кнопок командной панели, контекстного меню или открытия формы документа из списка.

В отчётах и обработках ссылка может приходить в параметре или выбираться пользователем через поле ввода формы с типом ДокументСсылка.<ИмяДокумента>. После выбора пользователем значение уже готово к использованию, и дополнительное получение ссылки по номеру не требуется.

Порядок получения ссылки
  1. 1
    Определите контекст: модуль объекта, форма списка или внешняя обработка.
  2. 2
    Возьмите ссылку через Объект.Ссылка, ТекущиеДанные.Ссылка или менеджер документа по номеру и дате.
  3. 3
    Проверьте, что ссылка не равна Неопределено.
  4. 4
    Используйте ссылку для открытия формы или чтения реквизитов документа.

При передаче ссылки между клиентом и сервером важно учитывать контекст выполнения. Ссылка, полученная на клиенте, может быть передана на сервер для чтения данных, но операции с документом должны соответствовать правам доступа и режиму блокировок информационной базы.

Отличие ссылки от строки и веб-адреса

ПредставлениеЧто этоКогда подходит
ДокументСсылкаУказатель на документ в информационной базеРабота внутри 1С, открытие формы, чтение реквизитов
Строка(Ссылка)Текстовое представление ссылкиВывод в сообщение, запись в лог, отладка
Веб-адресСсылка для браузера, если поддерживается платформойОткрытие документа в веб-клиенте по ссылке

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

Если задача заключается в отправке пользователю ссылки по почте или мессенджеру, нужно уточнить, поддерживается ли в используемой конфигурации генерация веб-ссылок на документы. В противном случае безопаснее направить пользователя к открытию документа через интерфейс 1С, а не пытаться сформировать адрес вручную.

Проверка результата и безопасная работа

После получения ссылки рекомендуется проверить её на заполненность и, при необходимости, попробовать открыть форму документа в тестовом режиме. Если форма не открывается или реквизиты недоступны, причина может быть в отсутствии прав, удалении документа или несовместимости клиентского и серверного контекста.

Типичные ошибки
01
Считать ДокументСсылка готовой веб-ссылкой и вставлять её в браузер.
02
Сохранять строковое представление ссылки как постоянный идентификатор между базами.
03
Использовать ссылку без проверки на Неопределено, что вызывает ошибку при открытии формы.

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

Если ссылка используется в фоновых заданиях или расписаниях, убедитесь, что сеанс имеет необходимые права и что документ не будет удалён до выполнения задачи. При работе с данными, влияющими на бухгалтерию или налоговый учёт, дополнительная проверка особенно важна.

Контрольные точки

Как проверить результат

Ссылка получена и не равна Неопределено
Норма

Форма документа открывается, реквизиты читаются

Тревожный признак

Ошибка при открытии, документ не найден или удалён

Права доступа к документу
Норма

Пользователь может читать и, при необходимости, редактировать документ

Тревожный признак

Отказ в доступе или ограничение на редактирование

Когда стоит обратиться к специалисту

Самостоятельно можно получить ссылку и открыть форму документа в рамках своих прав. Обращение к программисту или администратору 1С целесообразно, если нужно настроить генерацию веб-ссылок, интеграцию с внешними системами или изменить типовую конфигурацию.

Риски возрастают при работе с документами, влияющими на остатки, расчёты с контрагентами или налоговые регистры. В таких случаях изменения и автоматизация лучше проводить после согласования с бухгалтерией и тестирования на отдельной копии базы.

Итог

Что важно запомнить

ДокументСсылка — внутренняя ссылка на документ, а не веб-адрес; получайте её в нужном контексте, проверяйте на пустоту и не храните строковое представление как постоянный идентификатор.

Часто задаваемые вопросы

Можно ли использовать ДокументСсылка в обычной строке?

Ссылку можно преобразовать в строку для отображения или логирования, но такая строка не является полноценной ссылкой для открытия документа в браузере. Для работы внутри 1С лучше использовать сам тип ДокументСсылка.

Как получить ссылку, если известны только номер и дата документа?

Обратитесь к менеджеру нужного документа и запросите ссылку по реквизитам, которые однозначно идентифицируют документ. Точный способ зависит от конфигурации, после получения обязательно проверьте результат на отсутствие значения.

Почему ссылка может не открывать документ?

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

Отличается ли ссылка в обычном приложении и веб-клиенте?

Тип данных одинаков, но способы открытия и формирования адреса для браузера могут различаться. Веб-ссылка не всегда может быть получена простым преобразованием ДокументСсылка в строку.