get_job_data

La función get_job_data se usa para obtener información detallada sobre las tareas especificadas.

Copied!
svc=resource/get_job_data&params={"itemId":<long>,
								  "col":[<long>]}

Parámetros

NombreDescripción
itemIdID 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

Copied!
[
	{
		"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

Copied!
"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

Copied!
"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

Copied!
"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

Copied!
"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:

ValorDescripción
0x01

Mensaje separado para cada unidad.

0x02Todas las unidades en un mensaje.
0x04Tipo de evento: llenado de combustible.
0x08Tipo de evento: descarga de combustible.
0x10Tipo de evento: nivel de combustible.
0x20Método de envío: email.
0x40Método de envío: SMS.

Contador de kilometraje

Copied!
"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

Copied!
"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

Copied!
"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ódigoDescripción
7Error al obtener el recurso con la ACL deseada (ADF_ACL_AVL_RES_VIEW_JOBS).
4Parámetros de entrada incorrectos.
Descargar archivo PDF
Descargar archivo Word

Ver también