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