Как открыть объект по ссылке в 1С

Ссылка на объект в 1С — это уникальный адрес документа, элемента справочника, записи регистра или отчёта, по которому программа может напрямую открыть нужную форму. Такие ссылки используются, когда коллега просит «посмотреть конкретный документ», когда нужно быстро вернуться к объекту из письма или мессенджера, а также при интеграции 1С с внешними системами.

В зависимости от ситуации применяются разные способы: команда «Перейти по ссылке» внутри клиента 1С, внешние ссылки формата e1cib, которые открываются из браузера или проводника, и программное открытие объекта через встроенный язык. Ниже разобраны все варианты с точными действиями и ограничениями.

Какие ссылки на объекты существуют в 1С

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

Именно навигационная ссылка нужна в повседневной работе: она однозначно указывает на объект в конкретной информационной базе. Внутри ссылки зашит уникальный идентификатор объекта (GUID), поэтому ссылка остаётся рабочей, пока объект не удалён из базы.

Как получить ссылку на объект

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

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

1. 1
   Откройте нужный документ или элемент справочника в 1С.
2. 2
   Нажмите кнопку «Ещё» в правом верхнем углу формы.
3. 3
   Выберите «Получить ссылку» — ссылка появится в окне или буфере обмена.
4. 4
   Скопируйте строку целиком, начиная с e1cib/data/.

Переход по ссылке внутри 1С

Когда ссылка уже есть — например, её прислал коллега в почте — откройте её через штатную команду. В тонком клиенте нажмите Ctrl+F11 или найдите в главном меню пункт «Перейти по ссылке» (в ряде конфигураций он доступен через меню «Сервис» или кнопку со значком ссылки на панели). Вставьте скопированную строку в поле и подтвердите ввод — откроется форма нужного объекта.

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

Открытие объекта по внешней ссылке e1cib

Формат e1cib позволяет открыть объект, не запуская предварительно клиент 1С вручную. Полная внешняя ссылка выглядит примерно так: e1cib/server/Сервер:ИмяБазы#e1cib/data/Документ.ЗаказКлиента?ref=... для клиент-серверного варианта или содержит путь к файловой базе. Такую строку можно вставить в адресную строку браузера, в диалог «Выполнить» (Win+R) или сохранить в ярлыке.

При переходе Windows вызовет зарегистрированный обработчик протокола e1cib — установленный клиент 1С, который подключится к указанной базе и откроет объект. Если клиент не установлен или протокол не зарегистрирован, ссылка не сработает: это исправляется установкой платформы с компонентом связи с внешними ссылками.

В веб-клиенте внешние ссылки работают иначе: используется URL опубликованной базы с параметром навигационной ссылки. Такой адрес можно сохранить в закладках браузера и открывать объект сразу после авторизации.

Программное открытие объекта по ссылке

Разработчики и администраторы открывают объекты из кода. Базовый приём — получить ссылку по уникальному идентификатору и передать её в форму или процедуру показа:

// Открыть форму документа по известной ссылке
ОткрытьЗначение(ДокументСсылка);

// Получить ссылку по строке с GUID
Ид = Новый УникальныйИдентификатор("a1b2c3d4-...");
СсылкаНаДокумент = Документы.РеализацияТоваровУслуг.ПолучитьСсылку(Ид);
ОткрытьЗначение(СсылкаНаДокумент);

// Получить навигационную ссылку объекта
НавСсылка = ПолучитьНавигационнуюСсылку(СсылкаНаДокумент);

Для перехода по навигационной ссылке из кода используется метод ПерейтиПоНавигационнойСсылке(). Перед открытием полезно проверять, что ссылка не пустая и объект существует, иначе пользователь увидит ошибку «Объект не найден».

Если НЕ СсылкаНаДокумент.Пустая() Тогда
    ПерейтиПоНавигационнойСсылке(ПолучитьНавигационнуюСсылку(СсылкаНаДокумент));
КонецЕсли;

Типичные проблемы и их решение

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

Вторая проблема — внешняя ссылка e1cib не открывается из браузера. Обычно это значит, что протокол не зарегистрирован в системе или установлена другая версия платформы. Переустановка клиента 1С с нужными компонентами решает вопрос. Также проверьте права: если у пользователя нет доступа к объекту, форма не откроется даже по корректной ссылке.

FAQ