update_report

La función update_report se usa para crear, modificar y eliminar plantillas de informes.

Copied!

svc=report/update_report&params={"itemId":<long>,
				 				 "id":<long>,
				 				 "callMode":"<text>",
				 				 "n":"<text>",
				 				 "ct":"<text>",
				 				 "p":"<text>",
				 				 "tbl":[
					 				 {
										 "n":"<text>",
										 "l":"<text>",
										 "c":"<text>",
										 "cl":"<text>",
										 "cp":"<text>",
										 "s":"<text>",
										 "sl":"<text>",
										 "filter_order":"<text>",
										 "p":"<text>",
										 "sch":{	
											 "f1":<uint>,
											 "f2":<uint>,
											 "t1":<uint>,
											 "t2":<uint>,
											 "m":<uint>,
											 "y":<uint>,
											 "w":<uint>,
											 "fl":<uint>
										 },
										 "f":<uint>
									 }
								 ]}

Parámetros

Nombre	Descripción
itemId	ID del recurso.
id	ID de la plantilla.
callMode	Acción: crear, actualizar, eliminar (create, update, delete).

Otros parámetros solo se requieren para crear y modificar plantillas. Se describen en la página get_report_data.

El parámetro p especifica la agrupación de la tabla y otros ajustes. Ejemplo:

Copied!

"p":"{
	\"grouping\":\"	
		{\"type\":\"total\",\"nested\":		/* enable grouping "Total" */
			{\"type\":\"year\"}}\"			/* enable nested grouping "Year" */
		}"
	}"

Tipos de agrupación básicos:

Tipo	Descripción
total	Total.
year	Año.
month	Mes.
week	Semana.
wday	Día de la semana.
mday	Día del mes.
day	Fecha.
shift	Turno.

Para ver los tipos de agrupación avanzados, obtenga la información de la tabla por medio de la solicitud get_report_tables (parámetro gt).

Para la tabla account_tree, se puede utilizar los siguientes parámetros:

Copied!

"p": "{
        \"account_tree\":{
                \"group\":<bool>,
                \"types\":"<text>"
        }
}"

Nombre	Descripción
group	Agrupación de elementos: 0: no; 1: sí. El valor predeterminado es 0.
types	Tipos de elementos incluidos en los resultados de la tabla: avl_account; avl_resource; user; avl_unit; avl_unit_group; avl_retranslator; avl_route. Por defecto, se incluyen todos los tipos de elementos.

Nombre

Descripción

group

Agrupación de elementos:

0: no;
1: sí.

El valor predeterminado es 0.

types

Tipos de elementos incluidos en los resultados de la tabla:

avl_account;
avl_resource;
user;
avl_unit;
avl_unit_group;
avl_retranslator;
avl_route.

Por defecto, se incluyen todos los tipos de elementos.

Ejemplo (todas las comillas dobles dentro del valor se deben escapar):

Copied!

    "p":"{\"account_tree\":{\"group\":1,\"types\":\"avl_account,avl_resource,user,avl_unit,avl_unit_group,avl_retranslator,avl_route\"}}"

Para la tabla driver_ddd, se puede utilizar el parámetro drv_activity (Actividad del conductor):

Copied!

"p": "{
	\"drv_activity\":"<text>"
	}"

Valor	Descripción
ddd	Utilizar datos de los archivos .ddd (por defecto).
online	Utilizar los datos de las actividades en línea.
binds_and_trips	Utilizar los datos de asignaciones y viajes.

Para la tabla driver_orders (Pedidos), se puede utilizar el parámetro order_filter (Filtración):

Copied!

"p":"{
	\"order_filter\":<uint>
}"

Valor	Descripción
0x1	Pedidos visitados. En desuso.
0x2	Pedidos no visitados. En desuso.
0x4	Pedidos visitados a tiempo. En desuso.
0x8	Pedidos visitados con atraso. En desuso.
0x10	Pedidos confirmados y rechazados.
0x20	Pedidos no confirmados y no rechazados.
0x40	Pedidos confirmados.
0x80	Pedidos rechazados.
0x100	Pedidos visitados.
0x200	Pedidos no visitados.
0x400	Pedidos visitados a tiempo.
0x800	Pedidos visitados con atraso.

Para la tabla unit_counter_sensors (Sensores contadores), se puede utilizar los siguientes parámetros:

sensor_val:min (valor mínimo del sensor);
sensor_val:max (valor máximo del sensor).

Copied!

"p": "{
	\"sensor_val\":{\"min\":\"10\",\"max\":\"14\"}
}"

Para gráficas:

Copied!

"p":"{
	\"sensor_mask\":"<text>",		/* máscara de sensor */
	\"instant_speed_base\":{
		\"mask\":"<text>"}}	/* máscara de sensor para pintar la línea de la gráfica por sensor */

Para dividir turnos en las tablas con turnos, utilice los siguientes parámetros:

Copied!

"p":{\"split_shifts\":1},
"s":{\"split_shifts\"}

Gráficas

Gráfica es una tabla en una plantilla.

Para agregar marcadores a la gráfica, agregue la tabla de marcadores a la plantilla y marcas de marcadores a la tabla de la gráfica.

Ejemplo de la tabla de marcadores:

Copied!

{"n":"unit_events",
 "l":"",
 "f":0,
 "c":"",
 "cl":"",
 "p":"",
 "sch":{
   "y":0,
   "m":0,
   "w":0,
   "f1":0,
   "f2":0,
   "t1":0,
   "t2":0},
 "sl":"",
 "s":"[\"chart_unit_events\"]"},

Ejemplo de marcas de marcadores:

Copied!

"p":"{
  \"chart_markers\":{
    \"f\":2556}
  }"
}

Marcadores/Estados disponibles:

Marcador	Marca	Descripción
unit_events	0x4	Eventos.
unit_fillings	0x8	Llenados de combustible.
unit_photos	0x10	Imágenes.
unit_stays	0x20	Estacionamientos.
unit_speedings	0x40	Excesos de velocidad.
unit_stops	0x80	Paradas.
unit_thefts	0x100	Descargas de combustible.
unit_videos	0x800	Vídeo.

Para cambiar el fondo de la gráfica de acuerdo con el estado de las unidades, agregue el marcador/estado a la plantilla y el parámetro chart_regions a la tabla de la gráfica.

ID	Descripción
chart_stops_regions	Paradas.
chart_engine_hours_regions	Horas de motor.
chart_conn_quality_regions	Pérdida de conexión.
chart_stays_regions	Estacionamientos.
chart_trips_regions	Viajes.
chart_speedings_regions	Excesos de velocidad.
chart_digital_sensors_regions	Sensores digitales.

Ajustes avanzados

Cada ajuste de plantilla es una columna de tabla. Para activar la opción, agregue la columna correspondiente a la plantilla.

Están disponibles los siguientes ajustes:

Tabla	Columna	Descripción
unit_stats	multi_drivers	Varios conductores/remolques.
unit_stats	precise_calculations	Kilometraje/Combustible/Contadores con una precisión de hasta dos decimales.
unit_stats	exclude_thefts	Excluir las descargas de combustible del consumo de combustible.
unit_stats	trips_mileage	Contar el kilometraje solo de los viajes.
unit_stats	intersect_zone	Tener en cuenta la intersección de la geocerca por el recorrido.
unit_stats	address_format	Formato de dirección.
unit_stats	time_format	Formato de hora.
unit_stats	us_units	Sistema de medidas.
unit_stats	shifts	Turnos.
unit_trips	render_msgs	Todos los mensajes en el mapa.
unit_trips	render_trips	Recorridos de viajes.
geozones	render_geozones	Geocercas.
unit_videos	render_unit_videos	Marcadores de vídeos.
unit_fillings	render_filling_markers	Marcadores de llenados de combustible.
unit_photos	render_unit_photos	Marcadores de imágenes.
unit_stops	render_stops_markers	Marcadores de paradas.
unit_speedings	render_speedings_markers	Marcadores de excesos de velocidad.
unit_thefts	render_theft_markers	Marcadores de descargas de combustible.
unit_events	render_events_markers	Marcadores de eventos.
unit_stays	render_stays_markers	Marcadores de estacionamientos.
unit_location	render_location_markers	Última ubicación de la unidad.
unit_stats_zones	all_resources	Geocercas de todos los recursos.
unit_stats_zones	desc_address	Agregue la descripción de la geocerca a la dirección.
unit_stats_zones	address_zones	Utilizar geocercas como direcciones.

El formato de dirección, el formato de hora, el turno y el sistema de medidas se especifican en el parámetro “p”.

Resultado devuelto

Para las solicitudes de creación o modificación:

Copied!

[
	<long>,		/* ID de plantilla */
	{
		"id":<long>,	/* ID de plantilla */
		"n":"<text>",	/* nombre */
		"ct":"<text>",	/* tipo de plantilla */
		"c":<uint>	/* suma de comprobación (crc16) */
	}
]

Los tipos de plantillas se describen en la página get_report_data.

Para las solicitudes de eliminación:

Copied!

[
	<long>,		/* ID de plantilla */
	null
]

Los códigos de errores posibles son:

Código	Descripción
7	Error al obtener el objeto con la ACL deseada (ADF_ACL_AVL_RES_EDIT_REPORTS).
6	Error no definido.
4	Parámetros de entrada incorrectos.

update_report

Parámetros

Gráficas

Ajustes avanzados

Resultado devuelto

Ver también