Другое · 7 мин
Как получить ссылку на картинку в 1С
Как в 1С:Предприятии получить ссылку на картинку: из хранилища значений, через HTTP-сервис и внешние файлы, с проверкой доступа и ограничениями.
В 1С:Предприятии картинка может храниться в разных местах: в значении типа ХранилищеЗначения, вложенном файле документа, каталоге внешних файлов или на отдельном веб-сервере. От того, где лежит файл, зависит, можно ли получить на него прямую ссылку и будет ли она работать за пределами информационной базы.
Прямая HTTP-ссылка реальна только тогда, когда изображение доступно по адресу в сети или опубликовано через встроенный веб-сервер или HTTP-сервис конфигурации. Если картинка лежит только внутри хранилища значений, ссылка в привычном понимании отсутствует: данные извлекаются программно, а не отдаются по URL.
Ниже разобраны основные способы получить ссылку на картинку, условия их применения и способы проверить, что ссылка действительно работает.
Откуда зависит возможность ссылки: хранилище, вложение или внешний файл
ХранилищеЗначения предназначено для хранения произвольных данных внутри базы, в том числе изображений. Доступ к такому файлу возможен только через встроенный язык: чтение значения, выгрузка во временный файл или передача на форму. Само по себе хранилище не генерирует веб-адрес, по которому картинку можно открыть в браузере.
Вложенные файлы, прикреплённые к документам или справочникам, также хранятся внутри базы. Ссылка на них возможна только если конфигурация предоставляет отдельный механизм выдачи вложений по HTTP, например через сервис или внешнюю обработку. Без такого механизма файл остаётся недоступным по прямому адресу.
Сравнение вариантов
Подходит для хранения внутри базы, прямая ссылка отсутствует, нужна программная выдача.
Позволяет получить обычную HTTP-ссылку, требует настройки доступа и путей.
Даёт программный контроль над отдачей картинки, но требует разработки и публикации.
Публикация картинки через HTTP-сервис 1С
Если изображение нужно сделать доступным по ссылке, один из надёжных способов — опубликовать его через HTTP-сервис конфигурации. Сервис принимает запрос с идентификатором картинки, извлекает данные из хранилища или файла и отдаёт их с соответствующим типом содержимого, например image/png или image/jpeg.
При этом важно настроить права доступа: анонимные пользователи не должны получать возможность читать любые вложения базы. Доступ можно ограничить аутентификацией, ролями или проверкой прав на конкретный объект, к которому относится картинка.
- 1Определить, где хранится картинка: в хранилище значений, вложении или внешнем файле.
- 2Создать или настроить HTTP-сервис, который принимает идентификатор изображения.
- 3В коде сервиса извлечь данные картинки и вернуть их с правильным типом содержимого.
- 4Проверить доступ по полученному адресу в браузере или через программный запрос.
Получение адреса картинки из кода 1С
Когда картинка уже выгружена во временный файл или расположена в известном каталоге сервера, путь к ней можно сформировать программно. В встроенном языке используются функции работы с файлами и каталогами, после чего адрес формируется из базового URL сервера и относительного пути к файлу.
Если файл находится только в хранилище значений, адрес получить напрямую не получится. Нужно сначала выгрузить значение во временный файл на диск или отдать его через собственный сервис, а уже затем сообщать пользователю ссылку на этот файл.
Картинки в веб-клиенте и мобильном приложении
В веб-клиенте изображения часто отображаются через элементы формы, а не через прямые ссылки. Пользователь видит картинку в интерфейсе, но скопировать адрес из адресной строки браузера не всегда получается, так как данные могут передаваться внутри сеанса 1С без отдельного URL.
Для мобильного приложения ситуация аналогичная: картинки загружаются через механизмы обмена данными с сервером. Если нужна ссылка для вставки во внешний канал, например мессенджер, потребуется отдельная публикация изображения через HTTP-сервис или файловое хранилище с открытым доступом.
Ограничения, права доступа и безопасность
Отдача картинок по ссылке создаёт риск несанкционированного доступа к данным, если не настроены проверки прав. Изображение, приложенное к закрытому документу, не должно становиться доступным по угадываемому адресу для всех сотрудников или для посторонних лиц.
Временные файлы, созданные в процессе выгрузки картинки, лучше удалять после использования, чтобы не оставлять лишних данных на диске сервера. Также стоит учитывать, что большие изображения, отдаваемые через HTTP-сервис, могут увеличивать нагрузку на базу и сеть.
Как проверить, что ссылка работает, и типичные ошибки
Проверка результата заключается в открытии полученного адреса в браузере или выполнении запроса извне информационной базы. Нормальным результатом является отображение изображения или код ответа сервера, соответствующий успешной отдаче файла.
Частыми ошибками являются попытка сформировать ссылку на данные из хранилища значений без выгрузки, отсутствие типа содержимого в ответе сервера и закрытие доступа из-за нехватки прав у текущего пользователя.
Как проверить результат
Картинка отображается без ошибок авторизации
Ошибка доступа, пустая страница или скачивание неизвестного файла
Возвращается изображение с правильным типом содержимого
Код ошибки 401, 403 или 404
Краткие рекомендации по выбору способа
Если картинка нужна только внутри информационной базы, достаточно работать с хранилищем значений или вложениями программно, без поиска ссылки. Когда изображение нужно показать вне 1С, например в письме или на сайте, выбирайте публикацию через HTTP-сервис или размещение в доступном веб-каталоге.
Перед внедрением любого способа проверьте, кто и при каких условиях сможет открыть ссылку, и убедитесь, что временные файлы не остаются на сервере после завершения работы.
Что важно запомнить
Прямая ссылка на картинку в 1С возможна только при публикации через HTTP-сервис или доступном веб-каталоге; из хранилища значений ссылку получить нельзя без программной выдачи файла.
Можно ли получить ссылку на картинку из хранилища значений?
Нет, не в привычном смысле веб-адреса. Данные из хранилища значений извлекаются программно, а не отдаются по URL. Чтобы получить ссылку, нужно выгрузить картинку во временный файл или настроить собственный сервис, который будет отдавать её по запросу.
Нужны ли права доступа для открытия ссылки на картинку?
Да, если изображение относится к закрытым документам или справочникам. Без проверки прав ссылка может стать доступной для неограниченного круга лиц, что представляет угрозу конфиденциальности данных.
Работает ли ссылка после закрытия сеанса 1С?
Зависит от способа публикации. Постоянный адрес на внешнем файле или опубликованном сервисе обычно остаётся рабочим, а временная ссылка на файл в локальном каталоге может перестать действовать после завершения сеанса или перезапуска сервера.
Что делать, если по ссылке открывается пустая страница?
Проверьте адрес, тип содержимого в ответе сервера и права текущего пользователя. Также убедитесь, что файл не был удалён и HTTP-сервис корректно возвращает изображение, а не ошибку доступа.
Можно ли использовать одну ссылку для веб-клиента и мобильного приложения?
Можно, если оба клиента имеют доступ к одному адресу и сервер отдаёт изображение в поддерживаемом формате. В некоторых конфигурациях элементы формы отображают картинку внутри сеанса без отдельной ссылки, тогда для мобильного приложения потребуется отдельная публикация.