Пред.   След.

GetElemBlob (ZWS)

Возвращает содержимое бинарного поля для конкретного элемента из базы данных слоя.

Является GET запросом.

Формат запроса

http://zuluserverhost:6473/zws/GetElemBlob/<layer>/<element>/<file><params>

Где обязательные path параметры (путь к ресурсу):

  • layer — имя слоя вместе с пространством имен. Указывается в формате namespace:layername (пространство_имен:имя_слоя).

  • element — указание идентификатора объекта в слое и таблицы базы данных нужного объекта.

    Указывается в формате: <идентификатор_объекта_SYS>_<имя_таблицы_БД>::Sys:<идентификатор_объекта_SYS>

    Например, для объекта 227 в слое teplosam база данных istok строка будет выглядеть 227_teplosam_istok::Sys:227

  • file — указание таблицы и поля с бинарным объектом.

    Указывается в формате: <имя_таблицы_БД>::<идентификатор_объекта_SYS>?

Необязательные query параметры:

  • BaseID — идентификатор базы данных.

  • QueryName — имя запроса.

  • thumbnail — предпросмотр.

  • thumbwidth — ширина предпросмотра.

Пример запроса

Пример 1

Получение содержимого поля фото (foto) котельной SYS 227 из базы данных (istok) слоя (teplosam):

http://zs.zulugis.ru:6473/zws/GetElemBlob/mo:defekt_demo/149_deff1::Sys:149/deff1::Фото аварии?

Пример 2

Получение фото из галереи, например, запрос для получения определенного файла из поля галерея :

http://zs.zulugis.ru:6473/zws/GetElemBlobItem/example:sample_doc/26_T2::INDEX:1/T2::Галерея?FileName=Нижняя зона.jpg.zlnk&BaseID=3&QueryName=Запрос1

Декодированная строка URL-кодирования (Percent-encoding)

http://zs.zulugis.ru:6473/zws/GetElemBlobItem/example:sample_doc/26_T2::INDEX:1/T2::%D0%93%D0%B0%D0%BB%D0%B5%D1%80%D0%B5%D1%8F?FileName=%D0%9D%D0%B8%D0%B6%D0%BD%D1%8F%D1%8F%20%D0%B7%D0%BE%D0%BD%D0%B0.jpg.zlnk&BaseID=3&QueryName=%D0%97%D0%B0%D0%BF%D1%80%D0%BE%D1%811

Где:

  • example:sample_doc — имя слоя вместе с пространством имен

  • 26_T2::INDEX:1 — указание идентификатора объекта 26 в слое и таблицы базы данных нужного объекта.

  • T2::Галерея — указание таблицы и названия поля.

  • FileName=Нижняя зона.jpg.zlnk — указание нужного имени файла из галереи.

  • BaseID=3 — номер (ID) БД в структуре слоя.

  • QueryName=Запрос1 — название запроса в БД.

Пример 3

Аналог примера 2 с получением картинки из поля БД c заданным размером (добавлены параметры thumbnail=yes и thumbwidth=300):

http://zs.zulugis.ru:6473/zws/GetElemBlobItem/example:sample_doc/26_T2::INDEX:1/T2::Галерея?FileName=Нижняя зона.jpg.zlnk&BaseID=3&QueryName=Запрос1&thumbnail=yes&thumbwidth=300

Пример ответа

В ответ приходит бинарный файл: картинка, документ и т.п.