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