get_job_data

The get_job_data function is used to receive detailed information about the specified jobs.

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

Parameters

Name Description
itemIdResource ID.
col

The array of job IDs. 

The field is optional. If it is not present, the function is executed for all the jobs.

Returned result

Copied!
[
	{
		"id":<long>,			/* job ID */
		"n":"<text>",				/* name */
		"d":"<text>",				/* description */
		"r":"<text>",				/* execution type (see below) */
		"at":<uint>,			/* activation time */
		"m":<uint>,				/* maximum executions limit, 0 — unlimited */
        "fl":<uint>,			/* delete the job when the maximum executions limit is reached, 1 — yes */ 
		"tz":<int>,				/* time zone, sec */
		"l":"<text>",				/* language used for the job */
		"st":{					/* state */
			"e":<int>,			/* enabled/disabled */
			"c":<uint>,			/* executions count */
			"l":<uint>			/* last execution time */
		},
		"sch":{					/* time limitation */
			"f1":<uint>,		/* the beginning of the interval 1 */
			"f2":<uint>,		/* the beginning of the interval 2 */
			"t1":<uint>,		/* the end of the interval 1 */
			"t2":<uint>,		/* the end of the interval 2 */
			"m":<uint>,			/* the mask of days of month */
			"y":<uint>,			/* the mask of months */
			"w":<uint>,			/* the mask of days of week */
			"fl":<int>			/* schedule flags */
		},
		"act":{					/* actions (see the list of actions) */
			"t":"<text>",			/* type */
			"p":{				/* parameters */
				"<text>":"<text>",	/* name: value */
				...
			}
		},
		"ct":<uint>,   			/* creation time */  
		"mt":<uint>     		/* last modification time */
	}
]

There are two available types of execution:

  • Form a detailed list of executions according to a precise schedule. In this case, the format of the r field is “1 …”, where after 1, the execution time should be indicated. If there should be several executions, use a space to separate their time. The time format is “hours:minutes” or “hours”.
  • Set an interval between executions. If there should be a definite interval between job executions, the format of the r field is “2 …”, where after 2, indicate in Unix format the interval after which the job must be executed iteratively.

Action types

The following types of actions are available for jobs:

Send a command to units

Copied!
"act":{
	"t":"exec_unit_cmd",		/* action type */
	"p":{
		"cmd_name":"<text>",		/* command name */
		"cmd_type":"<text>",		/* command type */
		"cmd_param":"<text>",		/* command parameter */
		"link_type":"<text>",		/* link type */
		"timeout":"<text>",		/* the time during which the system will try to execute the command, s */
		"units":"<text>"			/* the list of IDs of units/unit groups (separated by commas) */
	}
}

You can find the list of available command types here.

Change access to units

Copied!
"act":{
	"t":"change_access_user",	/* action type */
	"p":{
		"acl_bits":"<text>",		/* 1 — set bit, 0 — remove bit */
		"acl_mask":"<text>",		/* the mask of bits to be changed */
		"units":"<text>",			/* the list of IDs of units/unit groups (separated by commas) */
		"users":"<text>"			/* the list of IDs of users (separated by commas) */
	}
}

Send a report by email

Copied!
"act":{
	"t":"send_email_report",	/* action type */
	"p":{
		"email_to":"<text>",		/* email addresses separated by commas */
		"file_type":"<text>",		/* file format */
		"flags":"<text>",			/* interval flags */
		"params":"<text>",		/* report configuration (XML) */
		"report_guid":"<text>",	/* resource ID */
		"report_id":"<text>",		/* report template ID */
		"report_objects":"<text>",/* the list of unit IDs separated by commas */
		"time_from":"<text>",		/* the beginning of time interval */
		"time_to":"<text>"		/* the end of time interval */
	}
}

The interval flags are described here.

File formats (ZIP archive content):

  • 1 — HTML;
  • 2 — PDF;
  • 4 — XLS;
  • 8 — XLSX;
  • 16 — XML;
  • 32 — CSV.

Send fuel information by email or SMS

Copied!
"act":{
	"t":"send_email_sms_fuel",	/* action type */
	"p":{
		"email_to":"<text>",		/* email addresses separated by commas */
		"flags":"<text>",			/* flags (see below) */
		"phone_to":"<text>",		/* phone numbers */
		"time_offset":"<text>",	/* time offset, min */
		"units":"<text>"			/* the list of IDs of units/unit groups (separated by commas) */
	}
}

Flags:

ValueDescription
0x01Separate message for each unit.
0x02All units in one message.
0x04Event type: fuel filling.
0x08Event type: fuel drain.
0x10Event type: fuel level.
0x20Delivery method: email.
0x40Delivery method: SMS.

Mileage counters

Copied!
"act":{
	"t":"reset_unit_mileage_counter",	/* action type */
	"p":{
		"param_name":"<text>",		/* parameter name; if it's empty, the counter value isn't stored as parameter of unit data message */
		"skip_reset":"<text>",		/* set new value for the mileage counter (0 — yes, 1 — no) */
		"store_mileage":"<text>",		/* store counter value in unit history */
		"units":"<text>",				/* list of IDs of units/unit groups (separated by commas) */
		"value_mileage":"<text>"		/* new value of mileage counter, m */
	}
}

Engine hours counters

Copied!
"act":{
	"t":"reset_unit_engine_hours_counter",	/* action type */
	"p":{
		"param_name":"<text>",		/* parameter name; if it's empty, the counter value isn't stored as parameter of unit data message */
		"skip_reset":"<text>",		/* set new value for the engine hours (0 — yes, 1 — no) */
		"store_eh":"<text>",			/* store counter value in unit history */
		"units":"<text>",				/* list of IDs of units/unit groups (separated by commas) */
		"value_eh":"<text>"			/* new value of engine hours, s */
	}
}

GPRS traffic counters

Copied!
"act":{
	"t":"reset_unit_bytes_counter",	/* action type */
	"p":{
		"reset_bytes":"<text>",		/* reset counter value (1 — yes, 2 — no) */
		"store_bytes":"<text>",		/* store counter value in unit history (1 — yes, 0 — no) */
		"units":"<text>"				/* list of IDs of units/unit groups (separated by commas) */
	}
}

Possible error codes:

CodeDescription
7Failed to fetch the resource with the desired ACL (ADF_ACL_AVL_RES_VIEW_JOBS).
4Wrong input parameters.
Download PDF file
Download Word document

See also