print/data
Метод возвращает одно задание печати из очереди учётной системы в том же формате XML, в котором сервер печати принимает файлы из каталога обмена. Учётная система удаляет переданное задание из очереди.
Метод
| Свойство | Значение |
|---|---|
| Тип | GET |
| Путь | /api/print/data |
Условия вызова
Сервер печати Scanport PrintServer вызывает метод при одновременном соблюдении условий:
- на вкладке Настройка обмена выбран тип обмена Очередь печати в учётной системе;
- метод print/data/check вернул
items_numбольше0.
Задания попадают в очередь, если в учётной системе включена очередь печати — вкладка Печать настроек устройств.
Запрос
Параметры
Параметров строки запроса нет.
Тело
Тела у запроса нет.
Пример запроса
http://192.168.1.1/DM/hs/DataMobileExch/api/print/data
Ответ
Ответ приходит в формате XML с корневым тегом PrintData. Состав переменных
зависит от модулей DataMobile в конфигурации учётной системы и описан в статье
Параметры XML-файлов; готовые
файлы — в статье Примеры XML-файлов.
Пример ответа
<?xml version="1.0" encoding="UTF-8"?>
<PrintData>
...
</PrintData>
Пустая очередь
Если вызвать метод при пустой очереди, модули DataMobile в 1С
отвечают исключением с кодом 901:
{
"description": "Очередь печати пуста. "
}
Коды ответов и формат тела исключения — в статье Исключения.
Порядок вызовов
| Правило | Значение |
|---|---|
| Сколько раз вызывается за один опрос | Столько, сколько заданий назвал items_num, но не более 10 |
| Что происходит с остатком | Забирается следующим опросом |
| Периодичность опроса | Задаётся параметром Интервал опроса на вкладке Основные |
Ограничение в десять запросов нужно, чтобы следующий опрос не начинался, пока обрабатывается предыдущий.
Связанные статьи
- print/data/check — проверка очереди перед запросом данных
- Параметры XML-файлов — переменные ответа
- Настройка обмена — вкладка сервера печати, где задаются адрес публикации и интервал опроса