Содержание

Задания: подробная информация

Для того, чтобы получить подробную информацию об интересующих вас заданиях, нужно использовать команду resource/get_job_data:

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

Параметры

Название Описание
itemId ID ресурса
col массив идентификаторов заданий

Возвращаемый результат

[
	{
		"id":<long>,	/* ID задания */
		"n":<text>,	/* название */
		"d":<text>,	/* описание */
		"r":<text>,	/* тип выполнения (см. ниже) */
		"at":<uint>,	/* время активации */
		"m":<uint>,	/* максимальное количество раз выполнения задания, 0 - не ограничено */
		"tz":<int>,	/* часовой пояс (сек) */
		"l":<text>,	/* язык, используемый для задания */
		"st":{		/* состояние */
			"e":<int>,	/* активно/неактивно */
			"c":<uint>,	/* количество выполнений */
			"l":<uint>	/* время последнего выполнения */
		},
		"sch":{		/* ограничение по времени */
			"f1":<uint>,	/* время начала интервала 1 */
			"f2":<uint>,	/* время начала интервала 2 */
			"t1":<uint>,	/* время окончания интервала 1 */
			"t2":<uint>,	/* время окончания интервала 2 */
			"m":<uint>,	/* маска дней месяца */
			"y":<uint>,	/* маска месяцев */
			"w":<uint>	/* маска дней недели */
		},
		"act":{		/* действие (список действий см. ниже) */
			"t":<text>,	/* тип */
			"p":{		/* параметры */
				<text>:<text>,	/* имя параметра: значение */
				...
			}
		},
		"ct":<uint>,    /* время создания */  
		"mt":<uint>     /* время последнего изменения */
	}
]

Тип выполнения может быть двух видов: по точному графику и выполнение через каждое указанное количество часов. Если нужно задать точный график, то формат поля «r» будет вида «1 …»: после цифры 1 указывается время выполнения задания, если таких значений несколько, то они указываются через пробел. Время может быть указано «часы:минуты» либо просто «часы». Если нужно указать выполнение через каждое указанное количество часов, то формат поля «r» будет вида «2 …»: после цифры 2 указывается время через которое задание должно повторятся в формате Unix time.

Типы действий

Выполнить команду над объектом

"act":{
	"t":"exec_unit_cmd",		/* тип действия */
	"p":{
		"cmd_name":<text>,	/* имя команды */
		"cmd_type":<text>,	/* тип команды */ 
		"cmd_param":<text>,	/* параметр команды */
		"link_type":<text>,	/* тип связи */
		"timeout":<text>,	/* время, в течение которого команда будет пытаться выполниться, сек */
		"units":<text>		/* список ID объектов/групп объектов (через запятую) */
	}
}

:!: Типы доступных команд можно посмотреть Список доступных команд

Учет GPRS-трафика

"act":{
	"t":"reset_unit_bytes_counter",	/* тип действия */
	"p":{
		"reset_bytes":<text>,	/* сбросить значение счетчика (1 - да, 2 - нет) */
		"store_bytes":<text>,	/* сохранять значение счетчика в истории объекта (1 - да, 0 - нет) */
		"units":<text>		/* список ID объектов/групп объектов (через запятую) */
	}
}

Изменить доступ к объектам

"act":{
	"t":"change_access_user",	/* тип действия */
	"p":{
		"acl_bits":<text>,	/* 1 - установить бит, 0 - снять бит */
		"acl_mask":<text>,	/* биты которые должны быть изменены */
		"units":<text>,		/* список ID объектов/групп объектов (через запятую) */
		"users":<text>		/* список ID пользователей (через запятую) */
	}
}

Учет пробега

"act":{
	"t":"reset_unit_mileage_counter",	/* тип действия */
	"p":{
		"param_name":<text>,		/* имя параметра, если пустое - не сохранять значение счетчика как параметр сообщения с данными у объекта */
		"skip_reset":<text>,		/* установить новое значение для счетчика пробега (0 - да, 1 - нет) */
		"store_mileage":<text>,		/* сохранять значение счетчика в истории событий объекта */
		"units":<text>,			/* список ID объектов/групп объектов (через запятую) */
		"value_mileage":<text>		/* новое значение для счетчика пробега (метров) */
	}
}

Учет моточасов

"act":{
	"t":"reset_unit_engine_hours_counter",	/* тип действия */
	"p":{
		"param_name":<text>,		/* имя параметра */
		"skip_reset":<text>,		/* установить новое значение для счетчика моточасов (0 - да, 1 - нет) */
		"store_eh":<text>,		/* сохранять значение счетчика как параметр сообщения с данными у объекта */
		"units":<text>,			/* список ID объектов/групп объектов (через запятую) */
		"value_eh":<text>		/* новое значение для счетчика моточасов (секунд) */
	}
}

Отправить информацию о топливе по e-mail или SMS

"act":{
	"t":"send_email_sms_fuel",	/* тип действия */
	"p":{
		"email_to":<text>,	/* e-mail адреса через запятую */
		"flags":<text>,		/* флаги (см. ниже) */
		"phone_to":<text>,	/* телефоны */
		"time_offset":<text>,	/* смещение времени, мин. */
		"units":<text>		/* список ID объектов/групп объектов (через запятую) */
	}
}

Флаги:

Значение Описание
0x01 Отдельное сообщение для каждого объекта
0x02 Все объекты в одном сообщении
0x04 Тип события: Заправка
0x08 Тип события: Слив
0x10 Тип события: Уровень топлива
0x20 Отправить сообщение по e-mail
0x40 Отправить сообщение по SMS

Отправить отчет по e-mail

"act":{
	"t":"send_email_report",	/* тип действия */
	"p":{
		"email_to":<text>,	/* e-mail адреса через запятую */
		"file_type":<text>,	/* формат файла (см. ниже) */
		"flags":<text>,		/* флаги интервала */
		"params":<text>,	/* конфигурация отчета (xml) */
		"report_guid":<text>,	/* ID ресурса */
		"report_id":<text>,	/* ID шаблона отчета */
		"report_objects":<text>,/* список ID элементов через запятую */
		"time_from":<text>,	/* начало временного интервала */
		"time_to":<text>	/* конец временного интервала */
	}
}

Флаги интервала рассмотрены в разделе Отчеты: Выполнение отчета.

Форматы файлов: