|
|
|
ru:kit:remoteapi:apiref:report:select_result_rows [20/06/2016 12:25]
|
ru:kit:remoteapi:apiref:report:select_result_rows [23/10/2020 12:05] (текущий)
|
| | ====== Выбрать строки в многоуровневых отчетах ====== |
| | Чтобы выбрать строки в многоуровневых отчетах (или в обычных без группировки), нужно использовать команду **report/select_result_rows**: |
| | <code javascript> |
| | svc=report/select_result_rows¶ms={"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>, |
| | "unitInfo":<int> |
| | } |
| | </code> |
| | Где, |
| | * **from** - индекс первой строки; |
| | * **to** - индекс последней строки; |
| | * **level** - уровень вложенности; |
| | * **flat** - вложенные уровни на одном уровне с родительскими: 0 - нет, 1 - да (необязательный параметр); |
| | * **rawValues** - отображать параметры **v**, **vt**: 0 - нет, 1 - да (необязательный параметр); |
| | * **unitInfo** - получить id объекта: 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|в этой статье]]. |
| |
