export_messages

Чтобы экспортировать в файл сообщения, загруженные в слой или по времени, используйте команду exchange/export_messages.

Copied!
svc=exchange/export_messages&params={"layerName":<text>,
                     "format":<text>,
                     "itemId":<long>,
                     "timeFrom":<uint>,
                     "timeTo":<uint>,
                     "compress":<bool>}

Этот запрос нельзя выполнить одновременно с другими запросами из этого раздела, а также со следующими запросами:

Параметры

Обязательные параметры обозначены звездочкой (*).

Имя

Описание

layerName

Имя слоя с сообщениями. Укажите для экспорта сообщений из слоя.

itemId

ID объекта. Укажите для экспорта сообщений без загрузки в слой.

format*

Формат файла: txt, kml, plt, wln, wlb.

timeFrom

Начало интервала. Укажите для экспорта сообщений без загрузки в слой.

timeTo

Конец интервала. Укажите для экспорта сообщений без загрузки в слой.

compress*

Укажите 1, чтобы получить сжатый файл, или 0, чтобы получить файл в несжатом виде.

Возвращаемый результат

При успешном выполнении запроса возвращается файл в указанном формате.

Если в параметрах запроса содержатся поля itemIdtimeFromtimeToformat и compress, то по значению поля itemId определяется объект, а затем возвращаются его сообщения от timeFrom до timeTo. Поле layerName в этом случае не учитывается, даже если оно указано в запросе. Если же хотя бы одно из полей temIdtimeFromtimeToformatcompress отсутствует, то по значению поля layerName определяется слой, затем по слою определяется объект и возвращаются все его сообщения (в этом случае поля timeFrom и timeTo не учитываются). Таким образом, команду можно использовать двумя способами. Для первого необходимы поля itemIdtimeFromtimeToformat и compress, а для второго — layerNameformat и compress.

Если запрос выполнить не удалось, возвращается код ошибки.

Коды ошибок

Код ошибкиОписание
1Неверный или устаревший SID запроса.
4

Одна из следующих ошибок:

  • ошибка валидации параметров,
  • слой не найден,
  • не удалось сохранить сообщения во временный файл.
6

Одна из следующих ошибок:

  • не удалось получить данные о пользователе,
  • не удалось получить рендерер,
  • ошибка сжатия файла.
7

Одна из следующих ошибок:

  • объект не найден,
  • не удалось получить объект, на который есть необходимые права доступа (для первого способа необходимо ADF_ACL_ITEM_EXECUTE_REPORTS, для второго  ADF_ACL_AVL_UNIT_EXPORT_MSGS).
1001У объекта нет сообщений за указанный период или за все время.
Скачать файл PDF
Скачать документ Word

Смотрите также