select_result_rows
Функция select_result_rows используется для выбора строк в многоуровневых отчетах.
svc=report/select_result_rows¶ms={"tableIndex":<int>,
"config":{
"type":"<text>",
"data":{}
}}
Параметры
Название | Описание |
---|---|
tableIndex | Индекс таблицы. |
config | Конфигурация. |
type | Тип запроса:
|
data | Данные для конфигурации. |
Если параметр type равен range, параметр data имеет следующий формат:
"data":{
"from":<uint>,
"to":<uint>,
"level":<uint>,
"flat":<uint>,
"rawValues":<uint>,
"unitInfo":<uint>
}
Опция | Описание |
---|---|
from | Индекс первой строки. |
to | Индекс последней строки. |
level | Уровень вложенности. |
flat | Показывать вложенный уровень на одном уровнем с родительским:
Необязательный параметр. Значение по умолчанию 0. |
rawValues | Показывать параметры v, vt:
Необязательный параметр. Значение по умолчанию 0. |
unitInfo | Показывать id объекта:
Необязательный параметр. Значение по умолчанию 0. |
Если параметр type равен row, параметр data имеет следующий формат:
"data":{
"rows":[<int>],
"level":<uint>,
"flat":<int>,
"rawValues":<uint>,
"unitInfo":<uint>,
"from":<int>,
"to":<int>
}
Опция | Описание |
---|---|
rows | Индекс строки. Можно указать индекс вложенной строки до предпоследнего уровня вложенности. |
level | Уровень вложенности. |
flat | Показывать вложенный уровень на одном уровнем с родительским:
Необязательный параметр. Значение по умолчанию 0. |
from | Индекс первой вложенной строки (необязательный) параметр. |
to | Индекс последней вложенной строки (необязательный) параметр. |
rawValues | Показывать необработанные данные значений:
Необязательный параметр. Значение по умолчанию 0. |
unitInfo | Показывать id объекта:
Необязательный параметр. Значение по умолчанию 0. |
Возвращаемый результат
[
{
"n":<uint>, /* индекс строки (от 0) */
"i1":<uint>, /* номер первого сообщения в указанном интервале */
"i2":<uint>, /* номер последнего сообщения в указанном интервале */
"t1":<uint>, /* время первого сообщения в указанном интервале */
"t2":<uint>, /* время последнего сообщения в указанном интервале */
"d":<int>, /* количество строк следующего уровня вложенности */
"uid":<long>, /* ID объекта; только если unitInfo равен 1 */
"c":[ /* массив ячеек */
{ /* общий тип ячеек */
"t":"<text>", /* форматированное значение ячейки */
"v":<double>, /* исходное значение ячейки */
"vt":<double>, /* тип значения */
"pi": { /* свойства */
"t":"<text>", /* тип свойства */
"ids": [ /* массив ID свойств */
]
},
"y":<double>, /* широта */
"x":<double>, /* долгота */
"c":"<text>" /* цвет ячейки (только если у ячейки есть цвет) в формате "RRGGBB" */
},
{ /* тип ячейки: видео или изображение */
"t":"<text>", /* текст значения ячейки */
"j":<JSON>, /* значение ячейки в формате JSON */
"v":<double>, /* значение ячейки */
"vt":<int> /* тип значения ячейки */
},
],
"r":[ /* содержит подстроки, которые соответствуют запрошенному уровню вложенности */
{ /* набор полей строки будет такой же, как и для родительской строки */
"n":<uint>,
"i1":<uint>,
"i2":<uint>,
...
}
]
}
]
Типы значений описаны здесь.
Возможные коды ошибок:
Код | Описание |
---|---|
7 | Не удалось извлечь библиотеку отчетов. |
6 | Не удалось извлечь пользователя. |
5 | Ошибка чтения/записи файла отчета. |
4 | Неверные входные параметры. |