Wialon para desarrolladores Manual de usuario Documentación de API report select_result_rows

select_result_rows

El método report/select_result_rows permite obtener filas de informes multinivel.

Endpoint

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

Parámetros

Parámetro Descripción
tableIndex Índice de la tabla. Para obtener las filas de la tabla de estadísticas, especifique -1.
config Configuración.
type Tipo de solicitud:
  • range: secuencia ordenada de filas;
  • row: fila.
data Datos para la configuración.

Si el parámetro type es range, el parámetro data tiene el siguiente formato:

Copied!
"data": {
  "from": <uint>,
  "to": <uint>,
  "level": <uint>,
  "flat": <uint>,
  "rawValues": <uint>,
  "unitInfo": <uint>
}
Opción Descripción
from Índice de la primera fila.
to Índice de la última fila.
level Nivel de anidamiento.
flat Mostrar el nivel de anidamiento en el mismo nivel que la fila principal:
  • 0: no;
  • 1: sí.

Este parámetro es opcional. El valor predeterminado es 0.
rawValues Mostrar los parámetros v y vt y el objeto pi en las celdas:
  • 0: no;
  • 1: sí.

Este parámetro es opcional. El valor predeterminado es 0.

El objeto pi contiene el tipo y los ID de los elementos del sistema relacionados con el valor de la celda, por ejemplo, una geocerca o un conductor. Para obtener más información, consulte Elementos relacionados con los valores de las celdas.
unitInfo Mostrar el parámetro uid:
  • 0: no;
  • 1: sí.

Este parámetro es opcional. El valor predeterminado es 0.

Si el parámetro type es row, el parámetro data tiene el siguiente formato:

Copied!
"data": {
  "rows": [<int>],
  "level": <uint>,
  "flat": <int>,
  "rawValues": <uint>,
  "unitInfo": <uint>,
  "from": <int>,
  "to": <int>
}
Opción Descripción
rows Índice de la fila. Puede especificar el índice de una fila anidada hasta el penúltimo nivel de anidamiento.
level Nivel de anidamiento.
flat Mostrar el nivel de anidamiento en el mismo nivel que la fila principal:
  • 0: no;
  • 1: sí.

Este parámetro es opcional. El valor predeterminado es 0.
from Índice de la primera fila anidada (opcional).
to Índice de la última fila anidada (opcional).
rawValues Mostrar los parámetros v y vt y el objeto pi en las celdas:
  • 0: no;
  • 1: sí.

Este parámetro es opcional. El valor predeterminado es 0.

El objeto pi contiene el tipo y los ID de los elementos del sistema relacionados con el valor de la celda, por ejemplo, una geocerca o un conductor. Para obtener más información, consulte Elementos relacionados con los valores de las celdas.
unitInfo Mostrar el parámetro uid:
  • 0: no;
  • 1: sí.

Este parámetro es opcional. El valor predeterminado es 0.

Respuesta

Copied!
[
  {
    "n": <uint>,                   /* índice de la fila (desde 0) */
    "i1": <uint>,                  /* número del primer mensaje en el intervalo especificado */
    "i2": <uint>,                  /* número del último mensaje en el intervalo especificado */
    "t1": <uint>,                  /* hora del primer mensaje en el intervalo especificado */
    "t2": <uint>,                  /* hora del último mensaje en el intervalo especificado */
    "d": <int>,                    /* cantidad de filas con el siguiente nivel de anidamiento */
    "uid": <long>,                 /* ID de la unidad; solo si unitInfo es 1 */
    "mrk": <long>,                 /* marca de evento falso: 1 si la fila contiene un evento marcado como falso; de lo contrario, 0 */
    "c": [                         /* matriz de celdas */
      {                            /* tipo de celda común */
        "t": "<text>",             /* valor de celda formateado */
        "v": <double>,             /* valor de celda original */
        "vt": <double>,            /* tipo de valor */
        "pi": {                    /* elementos relacionados con el valor de la celda; solo si rawValues es 1 */
          "t": "<text>",           /* tipo de elemento */
          "ids": [<long>]          /* matriz de ID de elementos */
        },
        "y": <double>,             /* latitud */
        "x": <double>,             /* longitud */
        "u": <long>,               /* ID de la unidad a la que pertenecen las coordenadas; solo para celdas con coordenadas */
        "c": "<text>"              /* color de celda (solo si la celda tiene un color) en el formato "RRGGBB" */
      },
      {                            /* tipo de celda: vídeo o imagen */
        "t": "<text>",             /* texto del valor de celda */
        "j": <JSON>,               /* valor de celda en formato JSON */
        "v": <double>,             /* valor de celda */
        "vt": <int>                /* tipo de valor de celda */
      }
    ],
    "r": [                         /* contiene las subfilas que corresponden al nivel de anidamiento solicitado */
      {                            /* el conjunto de campos de la fila coincide con el de la fila principal */
        "n": <uint>,
        "i1": <uint>,
        "i2": <uint>,
        ...
      }
    ]
  }
]

Para ver la descripción de los tipos de valores, consulte Tipos de valores.

El parámetro mrk es 1 para las filas con llenados o descargas de combustible marcados como falsos. Para marcar un llenado o una descarga de combustible como falso, utilice el método unit/update_events.

El objeto pi se devuelve para las celdas cuyo valor está relacionado con elementos del sistema, por ejemplo, una geocerca, un conductor o un remolque. El parámetro t del objeto contiene el tipo de elemento:

Valor Tipo de elemento
zone Geocerca.
driver Conductor.
traler Remolque.
sensor Sensor.
service_interval Intervalo de servicio.

Si en la plantilla de informe está activada la opción Utilizar geocercas como fuente de dirección y la dirección se reemplaza por el nombre de la geocerca, en la celda de dirección se devuelve el objeto pi con el tipo zone y el ID de la geocerca. De este modo, puede obtener los ID de las geocercas sin solicitudes adicionales.

Códigos de error

Código de error Descripción
4 Parámetros de entrada incorrectos.
5 Error de lectura/escritura del archivo de informe.
6 Error al obtener el usuario.
7 Error al obtener la biblioteca de informes.

Si nota un error en el texto, por favor resáltelo y presione Ctrl+Intro.