select_result_rows

Функция select_result_rows используется для выбора строк в многоуровневых отчетах.

Copied!
svc=report/select_result_rows&params={"tableIndex":<int>,
				      				  "config":{
				      					  "type":"<text>",
				      					  "data":{}
				      				  }}

Параметры

НазваниеОписание
tableIndexИндекс таблицы.
configКонфигурация.
typeТип запроса:
  • range — последовательность строк;
  • row — строка.
dataДанные для конфигурации.

Если параметр type равен range, параметр data имеет следующий формат:

Copied!
"data":{
	"from":<uint>,
	"to":<uint>,
	"level":<uint>,
	"flat":<uint>,
	"rawValues":<uint>,
	"unitInfo":<uint>
}

ОпцияОписание
fromИндекс первой строки.
to

Индекс последней строки.

level

Уровень вложенности.

flat

Показывать вложенный уровень на одном уровнем с родительским:

  • 0 — нет;
  • 1 — да.

Необязательный параметр. Значение по умолчанию 0.

rawValues

Показывать параметры v, vt:

  • 0 — нет;
  • 1 — да.

Необязательный параметр. Значение по умолчанию 0.

unitInfo

Показывать id объекта: 

  • 0 — нет;
  • 1 — да.

Необязательный параметр. Значение по умолчанию 0.

Если параметр type равен row, параметр data имеет следующий формат:

Copied!
"data":{
	"rows":[<int>],
	"level":<uint>,
	"flat":<int>,
	"rawValues":<uint>,
	"unitInfo":<uint>,
	"from":<int>,
	"to":<int>	
}

ОпцияОписание
rows

Индекс строки. Можно указать индекс вложенной строки до предпоследнего уровня вложенности.

level

Уровень вложенности.

flat

Показывать вложенный уровень на одном уровнем с родительским:

  • 0 — нет;
  • 1 — да.

Необязательный параметр. Значение по умолчанию 0.

from

Индекс первой вложенной строки (необязательный) параметр.

toИндекс последней вложенной строки (необязательный) параметр.
rawValues

Показывать необработанные данные значений: 

  • 0 — нет;
  • 1 — да.

Необязательный параметр. Значение по умолчанию 0.

unitInfo

Показывать id объекта: 

  • 0 — нет;
  • 1 — да.

Необязательный параметр. Значение по умолчанию 0.

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

Copied!
[
	{
		"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Неверные входные параметры.
Скачать файл PDF
Скачать документ Word

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