get_job_data
La función get_job_data se usa para obtener información detallada sobre las tareas especificadas.
svc=resource/get_job_data¶ms={"itemId":<long>,
"col":[<long>]}
Parámetros
Nombre | Descripción |
---|---|
itemId | ID del recurso. |
col | Matriz de los ID de tareas. El campo es opcional. Si no está presente, la función se ejecuta para todas las tareas. |
Resultado devuelto
[
{
"id":<long>, /* ID de tarea */
"n":"<text>", /* nombre */
"d":"<text>", /* descripción */
"r":"<text>", /* tipo de ejecución (vea más abajo) */
"at":<uint>, /* hora de activación */
"m":<uint>, /* cantidad máxima de ejecuciones, 0: no limitada */
"fl":<uint>, /* eliminar la tarea tras alcanzar la cantidad máxima de ejecuciones, 1: sí */
"tz":<int>, /* zona horaria, s */
"l":"<text>", /* idioma utilizado para la tarea */
"st":{ /* estado */
"e":<int>, /* activada/desactivada */
"c":<uint>, /* cantidad de ejecuciones */
"l":<uint> /* hora de la última ejecución */
},
"sch":{ /* limitación de tiempo */
"f1":<uint>, /* inicio del intervalo 1 */
"f2":<uint>, /* inicio del intervalo 2 */
"t1":<uint>, /* fin del intervalo 1 */
"t2":<uint>, /* fin del intervalo 2 */
"m":<uint>, /* máscara de los días del mes */
"y":<uint>, /* máscara de meses */
"w":<uint>, /* máscara de los días de la semana */
"fl":<int> /* marcas de horario */
},
"act":{ /* acciones (vea la lista de acciones más abajo) */
"t":"<text>", /* tipo */
"p":{ /* parámetros */
"<text>":"<text>", /* nombre: valor */
...
}
},
"ct":<uint>, /* hora de creación */
"mt":<uint> /* hora de la última modificación */
}
]
Están disponibles dos tipos de ejecución:
- Haga una lista detallada de las ejecuciones de acuerdo con un horario preciso. En este caso, el formato del campo r es " 1 …", donde después de 1 debe especificar la hora de ejecución. Si debe haber varias ejecuciones, utilice espacios para separar su hora. El formato de hora es “horas:minutos” u “horas”.
- Establezca un intervalo entre las ejecuciones. Si desea utilizar un intervalo específico, el formato del campo r es " 2 …", donde después de 2 en formato Unix debe especificar el intervalo después del cual la tarea debe volver a ejecutarse.
Tipos de acciones
Están disponibles los siguientes tipos de acciones para las tareas:
- Enviar un comando a las unidades;
- Modificar acceso a las unidades;
- Enviar un informe por email;
- Enviar información de combustible por email o SMS;
- Contador de kilometraje;
- Contador de horas de motor;
- Contador del tráfico GPRS.
Enviar un comando a las unidades
"act":{
"t":"exec_unit_cmd", /* tipo de acción */
"p":{
"cmd_name":"<text>", /* nombre de comando */
"cmd_type":"<text>", /* tipo de comando */
"cmd_param":"<text>", /* parámetro de comando */
"link_type":"<text>", /* tipo de enlace */
"timeout":"<text>", /* tiempo durante el cual se debe ejecutar el comando, s */
"units":"<text>" /* lista de ID de unidades/grupos de unidades (separados por comas) */
}
}
Puede encontrar la lista de los tipos de comandos disponibles aquí.
Modificar acceso a las unidades
"act":{
"t":"change_access_user", /* tipo de acción */
"p":{
"acl_bits":"<text>", /* 1: establecer bit, 0: eliminar bit */
"acl_mask":"<text>", /* máscaras de bits que deben cambiarse */
"units":"<text>", /* lista de ID de unidades/grupos de unidades (separados por comas) */
"users":"<text>" /* lista de ID de usuarios (separados por comas) */
}
}
Enviar un informe por email
"act":{
"t":"send_email_report", /* tipo de acción */
"p":{
"email_to":"<text>", /* direcciones de correo electrónico separadas por comas */
"file_type":"<text>", /* formato de archivo */
"flags":"<text>", /* marcas de intervalos */
"params":"<text>", /* configuración de informe (XML) */
"report_guid":"<text>", /* ID de recurso */
"report_id":"<text>", /* ID de plantilla de informe */
"report_objects":"<text>",/* lista de ID de unidades separados por comas */
"time_from":"<text>", /* inicio del intervalo de tiempo */
"time_to":"<text>" /* fin del intervalo de tiempo */
}
}
Las marcas de intervalos se describen aquí.
Formatos de archivos (contenido del archivo ZIP):
- 1: HTML;
- 2: PDF;
- 4: XLS;
- 8: XLSX;
- 16: XML;
- 32: CSV.
Enviar información de combustible por email o SMS
"act":{
"t":"send_email_sms_fuel", /* tipo de acción */
"p":{
"email_to":"<text>", /* direcciones de correo electrónico separadas por comas */
"flags":"<text>", /* marcas (vea más abajo) */
"phone_to":"<text>", /* números de teléfono */
"time_offset":"<text>", /* desplazamiento de tiempo, min */
"units":"<text>" /* lista de ID de unidades/grupos de unidades (separados por comas) */
}
}
Marcas:
Valor | Descripción |
---|---|
0x01 | Mensaje separado para cada unidad. |
0x02 | Todas las unidades en un mensaje. |
0x04 | Tipo de evento: llenado de combustible. |
0x08 | Tipo de evento: descarga de combustible. |
0x10 | Tipo de evento: nivel de combustible. |
0x20 | Método de envío: email. |
0x40 | Método de envío: SMS. |
Contador de kilometraje
"act":{
"t":"reset_unit_mileage_counter", /* tipo de acción */
"p":{
"param_name":"<text>", /* nombre de parámetro; si el campo está vacío, el valor del contador no se guarda como parámetro de mensaje con los datos de la unidad */
"skip_reset":"<text>", /* establecer un nuevo valor para el contador de kilometraje (0: sí, 1: no) */
"store_mileage":"<text>", /* guardar el valor del contador en la historia de la unidad */
"units":"<text>", /* lista de ID de unidades/grupos de unidades (separados por comas) */
"value_mileage":"<text>" /* nuevo valor del contador de kilometraje, m */
}
}
Contador de horas de motor
"act":{
"t":"reset_unit_engine_hours_counter", /* tipo de acción */
"p":{
"param_name":"<text>", /* nombre de parámetro; si el campo está vacío, el valor del contador no se guarda como parámetro de mensaje con los datos de la unidad */
"skip_reset":"<text>", /* establecer un nuevo valor para las horas de motor (0: sí, 1: no) */
"store_eh":"<text>", /* guardar el valor del contador en la historia de la unidad */
"units":"<text>", /* lista de ID de unidades/grupos de unidades (separados por comas) */
"value_eh":"<text>" /* nuevo valor de las horas de motor, s */
}
}
Contador del tráfico GPRS
"act":{
"t":"reset_unit_bytes_counter", /* tipo de acción */
"p":{
"reset_bytes":"<text>", /* restablecer el valor del contador (1: sí, 2: no) */
"store_bytes":"<text>", /* guardar el valor del contador en la historia de la unidad (1: sí, 0: no) */
"units":"<text>" /* lista de ID de unidades/grupos de unidades (separados por comas) */
}
}
Los códigos de errores posibles son:
Código | Descripción |
---|---|
7 | Error al obtener el recurso con la ACL deseada (ADF_ACL_AVL_RES_VIEW_JOBS). |
4 | Parámetros de entrada incorrectos. |