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

Ссылка в 1С на объект базы — это навигационная ссылка вида e1cib/data/Документ.РеализацияТоваровУслуг?ref=.... Её копируют командой формы, вставляют в письмо или мессенджер, и коллега с доступом к той же базе открывает ровно этот документ. Для веб-клиента есть вариант попроще: адрес из строки браузера.

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

Какую ссылку вы на самом деле ищете

Сначала определитесь, что нужно получить. От этого зависит способ.

Ссылка не обходит права. Если у получателя нет доступа к документу, он увидит ошибку доступа, а не содержимое.

Адрес опубликованной базы: откуда его взять

Если базу опубликовали на веб-сервере, пользователи работают через браузер. Адрес базы виден в адресной строке: имя сервера и имя публикации, например http://server/buh. Его и нужно копировать целиком.

Тонкий клиент адрес публикации не показывает: он подключается напрямую. Узнать адрес можно у администратора или из настроек публикации в конфигураторе (меню «Администрирование → Публикация на веб-сервере»).

В веб-клиенте при открытии объекта адрес в строке браузера меняется: после адреса базы появляется фрагмент #e1cib/data/.... Это та же навигационная ссылка, только с префиксом базы. Копируйте адрес прямо из строки (Ctrl+L, затем Ctrl+C).

Навигационная ссылка на документ и справочник

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

Ссылка выглядит так:

e1cib/data/Документ.РеализацияТоваровУслуг?ref=9a1b00155d0b0e2511ee...

Что в ней важно:

• e1cib — служебный префикс, по нему система понимает, что это ссылка 1С;
• data — открытие конкретного объекта;
• Документ.РеализацияТоваровУслуг — вид и имя объекта метаданных;
• ref=... — уникальный идентификатор записи в базе.

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

Шпаргалка по видам навигационных ссылок

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

Пример из практики

Главный бухгалтер проверяет акты. Исполнитель не пишет «посмотрите реализацию от 10-го числа на Ромашку», а вставляет в чат одну ссылку. Проверяющий жмёт её через Win+R, попадает в документ, правит и возвращает ответ с исправленной ссылкой. На сотне документов в месяц это экономит десятки минут поиска по журналу.

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

Для нового документа, который ещё не записан, ссылки нет: сначала нажмите «Записать». Для непроведённого документа ссылка получается, проведение не требуется.

Как открыть полученную ссылку

Получатель может сделать это тремя способами:

1. Из самой 1С. Откройте главное меню (кнопка со значком меню слева в заголовке окна), найдите команду перехода по навигационной ссылке в сервисных пунктах, вставьте ссылку и подтвердите.
2. Через строку запуска Windows. Нажмите Win+R, вставьте ссылку целиком и нажмите Enter. Windows передаёт её установленному тонкому клиенту, и тот откроется на нужном объекте. Работает, если на компьютере установлена платформа и в 1С уже выполнен вход в эту базу.
3. Через ярлык или закладку. Ссылку можно положить в текстовый файл, заметку или задачу в трекере.

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

Ссылка на список и отчёт

Для списка тоже есть адрес: e1cib/list/Справочник.Контрагенты открывает список контрагентов, e1cib/list/Документ.РеализацияТоваровУслуг — журнал документов . Такой адрес не содержит идентификатора, поэтому подходит для любой копии базы той же конфигурации.

Его удобно вставлять в инструкции для сотрудников: «откройте список по ссылке». Сотрудник попадает в нужный раздел и не ищет его в меню.

Отправить объект по почте со ссылкой

Типичная ситуация: бухгалтер просит старшего проверить документ. Есть два пути.

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

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

Для коллег, которые работают только через веб-клиент, вместо e1cib/data/... отправляйте полный адрес из браузера (с адресом публикации и #). Голая навигационная ссылка в чат-клиентах не превращается в кликабельную.

Гиперссылки внутри документов, справочников и форм

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

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

Ещё одно место — поле типа «строка» с адресом сайта или почты. Чтобы по нему можно было щёлкнуть, оформляют отдельную надпись-гиперссылку рядом с полем или обрабатывают событие открытия.

Ссылки из отчётов и внешних источников

В отчётах значения в ячейках чаще всего расшифровываются двойным щелчком: открывается документ или справочник, а уже оттуда можно взять ссылку описанным выше способом. Отдельной ссылки «на ячейку отчёта» нет.

Для самого отчёта работает ссылка на форму: e1cib/app/Отчет.ИмяОтчета. Она откроет форму отчёта с настройками по умолчанию. Состав выбранных настроек и отборов ссылка не передаёт, поэтому в письме опишите условия отдельно.

Если нужно скопировать в 1С ссылку из внешнего источника (письмо, сайт), вставляйте её обычным Ctrl+V в строковое поле или в комментарий. Платформа не проверяет формат, поэтому после вставки убедитесь, что не потерялся протокол http:// или https:// и в конце нет лишних пробелов.

Ссылки в коде и в настройках

Разработчику пригодятся методы платформы:

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

// Ссылка на информационную базу (для веб-клиента или сервера)
АдресБазы = ПолучитьНавигационнуюСсылкуИнформационнойБазы();

// Открыть объект по сохранённой ссылке
ПерейтиПоНавигационнойСсылке(Ссылка);

Первый вызов возвращает строку e1cib/data/... для переданного объекта. Для веб-клиента строку можно склеить с адресом публикации и получить полный URL, который открывается в браузере. Метод адреса информационной базы возвращает адрес публикации, если база опубликована. На файловой базе без публикации он вернёт пустое значение, поэтому результат нужно проверять.

Если сохраняете ссылку в регистр или реквизит строки, храните именно навигационную строку, а не представление: представление (например, «Реализация 000123 от 10.02») для открытия не годится.

В настройках пользователя ничего специально для ссылок включать не нужно. Исключение — запуск ссылки из внешних программ: на компьютере должна стоять платформа 1С, иначе Windows не знает, чем открыть e1cib. Иногда помогает переустановка клиента с галочкой регистрации в системе.

Если ссылка не открылась

Разберём, что проверять, по порядку: от простого к сложному.

• Объект удалён. Платформа сообщит, что не нашла объект. Проверьте в журнале регистрации или у автора письма.
• Нет прав. Получатель видит ошибку доступа. Решает администратор через роли.
• Другая база. Идентификаторы разные, ссылка не подойдёт. Нужна ссылка именно из той базы, где вы работаете.
• Ссылка обрезана. Почтовые клиенты и мессенджеры иногда режут длинные строки на ? или =. Откройте письмо в исходном виде и проверьте конец строки.
• Windows не знает протокол. Если Win+R ничего не открывает, платформа не зарегистрировала обработчик e1cib. Запустите 1С хотя бы раз под тем же пользователем Windows и повторите.
• Веб-клиент. Проверьте, что публикация доступна из сети получателя и порт не закрыт.

Не пытайтесь править идентификатор вручную. Ссылка с изменённым ref откроет либо чужой объект, либо ничего.

Частые вопросы