update_report

Para crear, modificar y eliminar plantillas de informes, utilice el método report/update_report.

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>
    }
  ]
}

La solicitud debe contener los siguientes parámetros:

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

El parámetro tbl[].n es el nombre de sistema de la tabla. Depende del tipo de plantilla indicado en ct. Para obtener más información, consulte la sección Nombres y tipos de tablas.

Para crear o modificar una plantilla, la matriz tbl debe contener al menos una tabla. Si la matriz está vacía, la plantilla no se guarda y se devuelve el error 6.

El parámetro p especifica la agrupación de la tabla y otros ajustes. Algunos ajustes están disponibles solo para tablas específicas.

El parámetro grouping define cómo se agrupan las filas de la tabla:

"p":"{
    \"grouping\":\"   
        {\"type\":\"total\",\"nested\":    /* habilitar la agrupación «Total» */
            {\"type\":\"year\"}}\"         /* habilitar la agrupación anidada «Año» */
}"

Tipos de agrupación básicos:

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

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

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

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

    "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):

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

El parámetro drv_activity puede tener los siguientes valores:

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

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

El parámetro order_filter puede tener los siguientes valores:

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

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

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

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

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

Una gráfica es una tabla de una plantilla. Para las gráficas, se pueden utilizar los siguientes parámetros:

"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 agregar marcadores a la gráfica, agregue la tabla de marcadores a la plantilla y los flags de marcadores a la tabla de la gráfica. Ejemplo de la tabla de marcadores:

{"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_events_markers\"]"},

Ejemplo de flags de marcadores:

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

Marcadores/estados disponibles:

El flag 0x4 también agrega los marcadores de infracciones a la gráfica.

Los intervalos de eventos como viajes, paradas, estacionamientos, pérdidas de conexión y horas de motor se pueden utilizar como fondo de la gráfica. Para obtener más información sobre cómo se ve el fondo en la interfaz, consulte Propiedades de gráficas.

El fondo requiere dos objetos de la matriz tbl: la tabla de origen, que proporciona los intervalos, y la tabla de la gráfica.

En la tabla de origen, agregue el nombre de una de las columnas con intervalos al parámetro s. Por ejemplo, para mostrar los intervalos de los viajes, agregue lo siguiente al objeto unit_trips:

"s":"[\"chart_trips_regions\"]"

En la tabla de la gráfica, agregue el objeto chart_regions al parámetro p:

"p":"{
  \"chart_regions\":{
    \"0\":{
      \"id\":\"<text>\",
      \"name\":\"<text>\",
      \"color\":<uint>,
      \"priority\":<uint>}
  }}"

Las claves del objeto son los índices de los intervalos, que empiezan por 0. Para mostrar varios tipos de intervalos en una misma gráfica, agregue un objeto para cada uno de ellos.

Si id o name está vacío, el intervalo no se agrega a la gráfica.

Si no necesita las filas de la tabla de origen en el informe, deje vacíos sus parámetros c y cl. La tabla se sigue calculando y proporciona los intervalos para la gráfica.

Están disponibles las siguientes columnas:

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

Están disponibles los siguientes ajustes:

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

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

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

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

Para las solicitudes de eliminación:

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

Los tipos de plantillas se describen en la sección Tipos de plantillas de la página get_report_data.

De lo contrario, se devuelve un código de error.