GetBin

Синтаксис

<адрес веб-сервиса>/GetBin?mon=<моникер><параметры операции>

Описание

Операция GetBin предназначена для извлечения бинарных данных с сервера с помощью GET-запроса.

Комментарии

В зависимости от того объекта, для которого выполняется операция, в качестве моникера указывается моникер соединения с репозиторием или моникер какого-либо открытого экземпляра объекта. Необходимые моникеры возвращают различные операции Open*.

В качестве параметров операции могут указываться следующие значения:

Параметр Описание
<моникер соединения с репозиторием>!$Sys! + <идентификатор_документа_репозитория>[дополнительные параметры] Извлечение содержимого документа, сохраненного в репозитории.
Дополнительные параметры:
  • &attach. Указание необходимости загрузить документ. Допустимые значения параметра:
    • 1. Загрузка документа, при этом в заголовок формируемой ссылки будет добавлен параметр attachment. Пример: &attach=1.
    • 2. Открытие документа внутренним представлением браузера, при этом в заголовок формируемой ссылки будет добавлен параметр inline. Пример: &attach=2.
  • &filename. Наименование файла, с которым осуществляется загрузка. Используется вместе с параметром attach. Пример: &attach=1&filename=report.xls.
<моникер соединения с репозиторием>!Preview! + <ключ_объекта> Извлечение миниатюры объекта репозитория в формате PNG.
<моникер аналитической панели>!BinItem! + <id/key> Извлечение из аналитической панели изображения с указанными идентификатором/ключом.

Пример

Ниже приведен пример кода html-страницы, которая используется для получения бинарных данных с помощью операции GetBin. При открытии страницы осуществляется подключение к репозиторию и выполняются два действия:

Результаты выполнения операций будут открыты в новых страницах браузера.

Для уменьшения примера из кода исключен скрипт функции PostRequest, которая используется для выполнения операций в JSON формате. Код данной функции можно посмотреть в статье «Подключение к репозиторию».

<!DOCTYPE html <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<html>
<head>
<meta http-equiv="X-UA-Compatible" content="IE=edge" />
<title>Использование операции GetBin</title>
</head>
<body>
    <script language="javascript" type="text/javascript">
        var svc = "http://localhost:9090/axis2/services/PP.SOM.Som";
        OpenMetabase = { "OpenMetabase": { "tDef": { "id": "PPREPOSITORY" }, "tCreds": { "user": { "id": "pprepository" }, "pass": "pprepository" } } }
        OpenMetabaseResult = PostRequest(svc, OpenMetabase);
        /*
            Скрипт для PostRequest
        */
        //Выполнение GetBin
        url = svc + "/GetBin?mon=" + OpenMetabaseResult.OpenMetabaseResult.id + "!$Sys!LOGO";
        window.open(url);
        url = svc + "/GetBin?mon=" + OpenMetabaseResult.OpenMetabaseResult.id + "!Preview!12345";
        window.open(url);
    </script>
</body>
</html>

См. также:

Дополнительные операции