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