Работа с треками
Добавление трека
Запрос:
{
"server_token": "...",
"app_version": "...",
"controller": "WorkspaceActionController",
"query": {
"action": "insert",
"domain": "task_timings",
"params": {
"record": {
"task_id": 17,
"employee_id": 1,
"project_id": 1,
"priority": 0,
"begin": 1479283838,
"end": 1479370245,
"comment": "Комментарий к задаче"
}
}
}
}
task_id | Идентификатор задачи |
employee_id | Идентификатор сотрудника, для которого создается трек |
project_id | Идентификатор проекта |
priority | Приоритет добавляемого трека. Влияет на то, будет ли добавляемый трек перекрывать существующие или нет. Трек с более высоким приоритетом перекрывает треки с более низким. Возможные значения 0 или 2. Трек с приоритетом 1 добавить через API нельзя. |
begin | Время начала трека (по UTC) |
end | Время конца трека (по UTC) |
comment | Текстовый комментарий к треку |
Время должно указывать по UTC в секундах. Значения должны быть целыми, неотрицательными и время начала трека должно быть меньше времени его конца.
Ответ:
{"result":{"affected_ids":[1]}}
Редактирование трека
Запрос:
{
"server_token": "...",
"app_version": "...",
"controller": "WorkspaceActionController",
"query": {
"action": "update",
"domain": "task_timings",
"params": {
"filter": {
"task_timing_id": 1 или [1]
},
"record": {
"task_id": 17,
"project_id": 1,
"begin": 1479283838,
"end": 1479370245,
"comment": "Комментарий к задаче"
}
}
}
}
task_timing_id | Идентификатор трека, который нужно отредактировать. Также можно передать в качестве значения массив идентификаторов для массового редактирования. |
task_id | Идентификатор задачи |
project_id | Идентификатор проекта |
begin | Время начала трека (по UTC) |
end | Время конца трека (по UTC) |
comment | Текстовый комментарий к треку |
В параметре record можно задать только те поля, которые нужно изменить (все поля отправлять не обязательно).
Время должно указывать по UTC в секундах. Значения должны быть целыми, неотрицательными числами и время начала трека должно быть меньше времени его конца.
Редактировать таким образом можно только треки, добавленные через Web API.
Ответ:
{"result":{"affected_ids":[1]}}
Удаление трека
Запрос:
{
"server_token": "...",
"app_version": "...",
"controller": "WorkspaceActionController",
"query": {
"action": "remove",
"domain": "task_timings",
"params": {
"filter": {
"task_timing_id": 1 или [1]
}
}
}
}
task_timing_id | Идентификатор трека, который нужно удалить. Также можно передать в качестве значения массив идентификаторов для массового удаления. |
Удалять таким образом можно только треки, добавленные через Web API.
Ответ:
{"result":{"affected_ids":[1]}}