Различия

Здесь показаны различия между двумя версиями данной страницы.

Ссылка на это сравнение

ru:kit:remoteapi:apiref:report:select_result_rows [20/06/2016 12:25] (текущий)
Строка 1: Строка 1:
 +====== Выбрать строки в многоуровневых отчетах ======
 +Чтобы выбрать строки в многоуровневых отчетах,​ нужно использовать команду **report/​select_result_rows**: ​
 +<code javascript>​
 +svc=report/​select_result_rows&​params={"​tableIndex":<​int>,​
 +       "​config":​{
 +       "​type":<​text>,​
 +       "​data":​{}
 +       }}
 +</​code>​
 +
 +
 +:!: Использование данного запроса рассмотрено в примере [[../​../​codesamples/​reports]].
 +
 +===== Параметры =====
 +^ Название ^ Описание ^
 +| tableIndex | индекс таблицы |
 +| config | конфигурация |
 +| type | тип запроса:​\\ **range** - последовательность строк;​\\ **row** - строка |
 +| data | данные для конфигурации |
 +
 +Если ​ параметр //type// равен **range**, то //data// имеет следующий формат:​
 +<code javascript>​
 +"​data":​{
 + "​from":<​uint>,​
 + "​to":<​uint>,​
 + "​level":<​uint>,​
 + "​flat":<​int>,​
 + "​rawValues":<​int> ​
 +}
 +</​code>​
 +Где, ​
 +  * **from** - индекс первой строки;​
 +  * **to** - индекс последней строки;​
 +  * **level** - уровень вложенности;​
 +  * **flat** - вложенные уровни на одном уровне с родительскими:​ 0 - нет, 1 - да (необязательный параметр);​
 +  * **rawValues** - отображать параметры **v**, **vt**: ​ 0 - нет, 1 - да (необязательный параметр).
 +
 +
 +Если ​ параметр //type// равен **row**, то //data// имеет следующий формат:​
 +<code javascript>​
 +"​data":​{
 + "​rows":​[<​int>​],​
 + "​level":<​uint>,​
 + "​flat":<​int>,​
 + "​from":<​uint>,​
 + "​to":<​uint>​
 +}
 +</​code>​
 +Где, ​
 +  * **rows** - индекс строки (можно указывать индекс вложенной строки до предпоследнего уровня вложенности);​
 +  * **level** - уровень вложенности;​
 +  * **flat** - вложенные уровни на одном уровне с родительскими:​ 0 - нет, 1 - да (необязательный параметр);​
 +  * **from** - индекс первой вложенной строки (необязательный параметр); ​
 +  * **to** - индекс последней вложенной строки (необязательный параметр).
 +===== Возвращаемый результат =====
 +<code javascript>​
 +[
 + {
 + "​n":<​uint>,​ /​* индекс строки (от 0) */
 + "​i1":<​uint>,​ /​* номер первого сообщения в заданном интервале */
 + "​i2":<​uint>,​ /​* номер последнего сообщения в заданном интервале */
 + "​t1":<​uint>,​ /​* время первого сообщения в заданном интервале */
 + "​t2":<​uint>,​ /​* время последнего сообщения в заданном интервале */
 + "​d":<​int>,​ /​* количество строк следующего уровня вложенности */
 + "​c":​[ /​* массив ячеек */
 + <​text>,​ /​* значение ячейки текстовое */
 + { /* или объект */
 + "​t":<​text>,​ /​* форматированное значение ячейки */
 + "​v":<​double>,​ /​* исходное значение ячейки */
 + "​vt":<​double>,​ /​* тип значения */
 + "​pi":​ { /* подэлементы */
 + "​t":<​text>,​ /​* тип подэлементов */
 + "​ids":​ [ /* массив ID подэлементов */
 + ]
 + },
 + "​y":<​double>,​ /​* широта */
 + "​x":<​double>​ /​* долгота */
 + }
 + ],
 + "​r":​[ /​* содержит подстроки соответствующие уровню вложенности указанному при запросе */
 + { /* набор полей у подстроки будет такой же как и у родительской строки */
 + "​n":<​uint>,​
 + "​i1":<​uint>,​
 + "​i2":<​uint>,​
 + ...
 + }
 + ]
 + }
 +]
 +
 +</​code>​
 +
 +:!: Типы значений описаны в [[value_types|в этой статье]].
  
Follow us on Facebook Gurtam Wialon Twitter Gurtam Wialon info@gurtam.com   |   Copyright © 2002-2019 Gurtam