get_job_data

El método 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

Nombre Descripción
itemId ID del recurso.
col Matriz de los ID de tareas.
El campo es opcional. Si no está presente, el método se ejecuta para todas las tareas.

Respuesta

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 (sin límite) */
        "fl":<uint>,			/* eliminar la tarea después de su primera ejecución: 1 (sí), 0 (no) */
		"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>			/* flags 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) */
	}
}

Para obtener la lista de los tipos de comandos disponibles, use el método core/get_hw_cmds.

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>",			/* flags de intervalos */
		"params":"<text>",		/* configuración de informe (XML) */
		"report_guid":"<text>",	/* ID del recurso que contiene la plantilla de informe; puede ser cualquier recurso sobre el cual el creador del recurso tenga el derecho de acceso «Ver plantillas de informes». Si no hay acceso o la plantilla se ha eliminado, el informe no se envía */
		"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 */
	}
}

Los flags de intervalos se describen en la sección Flags de intervalo de la página report/exec_report.

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>",			/* flags (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) */
	}
}

Flags:

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

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ódigo Descripción
7 El recurso no existe o el usuario no tiene el derecho de acceso Ver tareas a él.
4 Parámetros de entrada incorrectos.

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