get_report_tables

Para obtener la lista de tablas que se pueden incluir en los informes, utilice el método report/get_report_tables.

svc=report/get_report_tables&params={}

La solicitud no requiere ningún parámetro.

Si la solicitud se completa correctamente, se devuelve una respuesta con el siguiente formato:

[
	{
		"id":<uint>,		/* ID de la tabla */
		"n":"<text>",			/* nombre de sistema de la tabla */
		"l":"<text>",			/* nombre predeterminado de la tabla */
		"t":"<text>",			/* tipo de la tabla */
		"ct":"<text>",		/* tipo de plantilla en la que se puede utilizar esta tabla */
		"pt":"<text>",		/* parámetros de texto */
		"gt":"<text>",		/* ajustes avanzados de agrupación */
		"col":[				/* matriz de columnas */
			{
				"n":"<text>",		/* nombre de sistema de la columna */
				"l":"<text>",		/* nombre predeterminado de la columna */
				"sl":"<text>",	/* lista de encabezados de columnas (si es una tabla de estadísticas) */
				"t":"<text>",		/* tipo de la columna */
				"f":<uint>		/* flags de la columna (vea más abajo) */
				"calc_type":<uint>		/* valor de agrupación (si está establecido) */
				"available_calc_types":<uint>		/* valores de agrupación disponibles para la columna (si corresponde) */
			}
		]
	}
]

Los tipos de plantillas de informes se describen en la sección Tipos de plantillas. Los flags de las tablas se describen en la página exec_report.

Cada tabla se registra por separado para cada tipo de plantilla, por lo que su valor n es único. La misma tabla tiene un nombre diferente en cada tipo de plantilla. Por ejemplo, la tabla Viajes es unit_trips en una plantilla avl_unit y unit_group_trips en una plantilla avl_unit_group. Utilice el valor n para indicar las tablas en la solicitud report/update_report.

Las tablas que tienen el mismo valor t se calculan de la misma manera. Para encontrar la tabla equivalente en otro tipo de plantilla, busque una tabla con el mismo valor t y el valor ct requerido.

No todas las tablas están disponibles para todos los tipos de plantillas. Por ejemplo, las tablas Gráfica (Regular), Movimiento de combustible, Imágenes, Seguimiento de mensajes y Vídeo están disponibles para las plantillas avl_unit, pero no tienen equivalente para avl_unit_group.

El contenido de la tabla unit_location (Últimos datos de la unidad) depende del tipo de plantilla. La tabla existe tanto para avl_unit como para avl_unit_group, pero en una plantilla avl_unit todas sus columnas son columnas de estadísticas con el flag 0x02. En este caso, la tabla no tiene filas y solo agrega un bloque a las estadísticas del informe. Como tabla regular, Últimos datos de la unidad está disponible únicamente para las plantillas avl_unit_group.

La lista devuelta también depende de la cuenta. Las tablas se filtran según los servicios disponibles para el usuario actual, por lo que distintos usuarios pueden recibir listas de tablas diferentes.

El parámetro f de una columna puede tener los siguientes valores:

El valor de f es una máscara de bits, por lo que una columna puede tener varios flags a la vez. Por ejemplo, 0x01 + 0x02 = 0x03 significa que la columna se muestra tanto como columna de tabla como columna de estadísticas.

Las columnas con los flags 0x100 y 0x200 pertenecen a las tablas que proporcionan los datos para la gráfica (por ejemplo, unit_events o unit_stays), no a la tabla de la gráfica en sí. Estas columnas definen lo que se visualiza en la gráfica. Para obtener más información, consulte las secciones Marcadores y Fondo.

El parámetro pt enumera los parámetros de texto y las opciones disponibles para la tabla. Puede tener los siguientes valores: