Поля задачи в REST 3.0
В блоке Объект задачи описаны все поля задачи, в других блоках — поля связанных объектов. Часть полей задачи доступна как число идентификатор и как объект, например creatorId и creator. Поле идентификатор используйте в методах создания и изменения задачи. Поле объект в методе получения задачи. Как работать с полями связанных объектов описано в статье Обзор REST API 3.0.
Права на запись и изменение полей зависят от роли пользователя в задаче, настроек прав на группу, иерархии сотрудников, статуса задачи и некоторых флагов в задаче, например allowChangeDeadline.
Объект задачи
|
Название |
Описание |
|
id |
Идентификатор задачи |
|
title |
Название задачи, обязательное поле для создания задачи |
|
description |
Описание задачи |
|
creatorId |
Идентификатор постановщика, обязательное поле для создания задачи |
|
creator |
Постановщик. Объект типа пользователь. Используйте для запроса данных в параметре |
|
created |
Дата создания в формате ISO-8601 |
|
responsibleId |
Идентификатор исполнителя, обязательное поле для создания задачи |
|
responsible |
Исполнитель. Объект типа пользователь. Используйте для запроса данных в параметре |
|
deadline |
Крайний срок в формате ISO-8601, например |
|
needsControl |
Контроль задачи постановщиком. Возможные значения: |
|
startPlan |
Плановая дата начала в формате ISO-8601, например |
|
endPlan |
Плановая дата окончания в формате ISO-8601, например |
|
checklist |
Идентификаторы пунктов чек-листов. Для работы с чек-листами используйте методы task.checklistitem.* |
|
groupId |
Идентификатор группы/проекта. Для работы с группами используйте методы sonet_group.* |
|
group |
Группа/проект. Объект типа группа. Используйте для запроса данных в параметре |
|
stageId |
Идентификатор стадии. Используйте, если задача находится в группе/проекте |
|
stage |
Стадия. Объект типа стадия. Используйте для запроса данных в параметре |
|
epicId |
Идентификатор эпика. Для работы с эпиками используйте методы tasks.api.scrum.epic.* |
|
storyPoints |
Стори поинты. Для изменения задачи Скрама используйте метод tasks.api.scrum.task.update |
|
flowId |
Идентификатор потока. Для работы с потоком используйте методы tasks.flow.Flow.* |
|
flow |
Поток. Объект типа поток. Используйте для запроса данных в параметре |
|
priority |
Приоритет задачи. Возможные значения:
|
|
status |
Статус задачи. Возможные значения:
|
|
statusChanged |
Дата изменения статуса в формате ISO 8601 |
|
accomplices |
Список идентификаторов пользователей — соисполнителей в методах создания или изменения задачи. |
|
auditors |
Список идентификаторов пользователей — наблюдателей за задачей в методах создания или изменения задачи. |
|
parentId |
Идентификатор родительской задачи. |
|
parent |
Родительская задача. Объект типа задача. Используйте для запроса данных в параметре |
|
containsChecklist |
Признак наличия чек-листа. Поле изменяется автоматически |
|
containsSubTasks |
Признак наличия подзадач. Поле изменяется автоматически |
|
containsRelatedTasks |
Признак наличия связанных задач. Поле изменяется автоматически |
|
containsGanttLinks |
Признак наличия связей в Гантте. Поле изменяется автоматически |
|
containsPlacements |
Признак наличия встроек. Поле изменяется автоматически |
|
containsResults |
Признак наличия результатов. Поле изменяется автоматически |
|
numberOfReminders |
Количество напоминаний по задаче. Поле изменяется автоматически |
|
chatId |
Идентификатор чата задачи. Для работы с чатом задачи используйте методы im.message.* |
|
chat |
Чат задачи. Объект типа чат задачи. Используйте для запроса данных в параметре |
|
plannedDuration |
Плановая длительность |
|
actualDuration |
Фактическая длительность |
|
durationType |
Единица плановой длительности. Возможные значения: |
|
started |
Дата начала выполнения в формате ISO 8601 |
|
estimatedTime |
Оценка времени в секундах |
|
replicate |
Признак повторяемой задачи. Возможные значения:
|
|
changed |
Дата изменения в формате ISO 8601 |
|
changedById |
Идентификатор пользователя, изменившего задачу |
|
changedBy |
Кто изменил. Объект типа пользователь. Используйте для запроса данных в параметре |
|
statusChangedById |
Идентификатор пользователя, изменившего статус |
|
statusChangedBy |
Кто изменил статус. Объект типа пользователь. Используйте для запроса данных в параметре |
|
closedById |
Идентификатор пользователя, закрывшего задачу |
|
closedBy |
Кто закрыл. Объект типа пользователь. Используйте для запроса данных в параметре |
|
closed |
Дата закрытия в формате ISO 8601 |
|
activity |
Дата последней активности в формате ISO 8601 |
|
guid |
Идентификатор |
|
xmlId |
Внешний идентификатор |
|
exchangeId |
Идентификатор Exchange |
|
exchangeModified |
Дата изменения в Exchange |
|
outlookVersion |
Версия синхронизации с Outlook |
|
mark |
Оценка задачи. Возможные значения: |
|
allowsChangeDeadline |
Разрешено менять крайний срок. Возможные значения:
|
|
allowsTimeTracking |
Включен учет времени по задаче. Возможные значения:
|
|
matchesWorkTime |
Учитывать рабочее время. Возможные значения:
|
|
addInReport |
Добавлять в отчет. Возможные значения:
|
|
isMultitask |
Признак «базовая задача с подзадачами». Возможные значения:
|
|
siteId |
Идентификатор сайта |
|
forkedByTemplateId |
Идентификатор шаблона, если задача создана из шаблона |
|
forkedByTemplate |
Шаблон задачи. Объект типа шаблон. Используйте для запроса данных в параметре |
|
maxDeadlineChangeDate |
Дата, после которой нельзя менять крайний срок, в формате ISO 8601 |
|
maxDeadlineChanges |
Максимальное количество переносов крайнего срока |
|
requireDeadlineChangeReason |
Требовать причину при изменении крайнего срока. Возможные значения:
|
|
link |
Ссылка на задачу |
|
rights |
Массив действий, которые пользователь может совершить с задачей |
|
archiveLink |
Ссылка на архив для скачивания всех файлов задачи |
|
crmItemIds |
Массив идентификаторов связанных объектов CRM в формате:
|
|
emailId |
Идентификатор письма, из которого создана задача |
|
email |
Письмо, из которого создана задача. Объект типа письмо. Используйте для запроса данных в параметре |
|
elapsedTime |
Учет времени. Объект типа учет времени. Используйте для запроса данных в параметре |
|
requireResult |
Требовать результат. Возможные значения:
|
|
matchesSubTasksTime |
Учитывать сроки подзадач. Возможные значения:
|
|
autocompleteSubTasks |
Автозавершение подзадач. Возможные значения:
|
|
allowsChangeDatePlan |
Разрешено менять плановые даты. Возможные значения:
|
|
inFavorite |
Признак «в избранном». В поле возвращается массив, в котором лежит ID текущего пользователя, если у него настройка активна |
|
inPin |
Признак «задача закреплена». В поле возвращается массив, в котором лежит ID текущего пользователя, если у него настройка активна |
|
inGroupPin |
Признак «задача закреплена в группе». В поле возвращается массив, в котором лежит ID текущего пользователя, если у него настройка активна |
|
inMute |
Признак «выключить звук». В поле возвращается массив, в котором лежит ID текущего пользователя, если у него настройка активна |
|
source |
Источник задачи. Объект источник. Используйте для запроса данных в параметре |
|
dependsOn |
Зависимости от задач |
|
scenarios |
Сценарий создания задачи. Возможные значения:
|
Объект пользователя
|
Название |
Описание |
|
id |
Идентификатор пользователя |
|
name |
Имя пользователя |
|
role |
Роль пользователя |
|
image |
Объект типа файл. Используйте для запроса данных в параметре |
|
gender |
Пол |
|
email |
|
|
externalAuthId |
Внешний auth ID |
|
rights |
Права пользователя |
Объект файла
|
Название |
Описание |
|
id |
Идентификатор файла |
|
src |
Ссылка на файл |
|
name |
Имя файла |
|
width |
Ширина |
|
height |
Высота |
|
size |
Размер |
|
subDir |
Подкаталог |
|
contentType |
MIME-тип |
|
file |
Данные файла |
Объект группы
|
Название |
Описание |
|
id |
Идентификатор группы |
|
name |
Название группы |
|
image |
Объект типа файл. Используйте для запроса данных в параметре |
|
type |
Тип группы |
|
isVisible |
Признак видимости |
Объект стадии
|
Название |
Описание |
|
id |
Идентификатор стадии |
|
title |
Название стадии |
|
color |
Цвет стадии |
Объект потока
|
Название |
Описание |
|
id |
Идентификатор потока |
|
name |
Название потока |
Объект чата задачи
|
Название |
Описание |
|
id |
Идентификатор элемента чата |
|
entityId |
Идентификатор объекта чата |
|
entityType |
Тип объекта чата |
Объект шаблона задачи
|
Название |
Описание |
|
id |
Идентификатор шаблона |
|
task |
Объект типа задача. Используйте для запроса данных в параметре |
|
title |
Название |
|
description |
Описание |
|
creator |
Объект типа пользователь. Используйте для запроса данных в параметре |
|
responsibleCollection |
Коллекция ответственных |
|
deadlineAfterTs |
Сдвиг крайнего срока |
|
startDatePlanTs |
Плановая дата начала |
|
endDatePlanTs |
Плановая дата окончания |
|
replicate |
Повторение задачи из шаблона |
|
checklist |
Массив идентификаторов пунктов чек-листов |
|
group |
Объект типа группа. Используйте для запроса данных в параметре |
|
priority |
Приоритет |
|
accomplices |
Соисполнители |
|
auditors |
Наблюдатели |
|
parent |
Родительский шаблон. Объект типа [шаблон задачи] |
|
replicateParams |
Объект параметров повторения. Используйте для запроса данных в параметре |
Объект параметров повторения шаблона
|
Название |
Описание |
|
period |
Периодичность |
|
everyDay |
Каждый день |
|
workdayOnly |
Только рабочие дни |
|
dailyMonthInterval |
Интервал в днях месяца |
|
everyWeek |
Каждую неделю |
|
monthlyType |
Тип ежемесячного повтора |
|
monthlyDayNum |
День месяца |
|
monthlyMonthNum1 |
Первый месяц периода |
|
monthlyWeekDayNum |
Номер недели в месяце |
|
monthlyWeekDay |
День недели |
|
monthlyMonthNum2 |
Второй месяц периода |
|
yearlyType |
Тип годового повтора |
|
yearlyDayNum |
День месяца для годового повтора |
|
yearlyMonth1 |
Первый месяц годового повтора |
|
yearlyWeekDayNum |
Номер недели для годового повтора |
|
yearlyWeekDay |
День недели для годового повтора |
|
yearlyMonth2 |
Второй месяц годового повтора |
|
time |
Время |
|
timezoneOffset |
Смещение часового пояса |
|
startDate |
Дата начала повторения |
|
repeatTill |
До какой даты повторять |
|
endDate |
Дата окончания повторения |
|
times |
Количество повторов |
Объект письма
|
Название |
Описание |
|
id |
ID письма |
|
taskId |
ID задачи |
|
mailboxId |
ID почтового ящика |
|
title |
Название письма |
|
body |
Тело письма |
|
from |
Отправитель письма |
|
dateTs |
Таймстамп отправки письма |
|
link |
Ссылка на письмо |
Объект учета времени
|
Название |
Описание |
|
id |
Идентификатор записи учета времени |
|
userId |
Пользователь |
|
taskId |
Задача |
|
minutes |
Минуты |
|
seconds |
Секунды |
|
source |
Источник |
|
text |
Комментарий |
|
createdAtTs |
Дата создания |
|
startTs |
Время старта |
|
stopTs |
Время завершения |
Объект источника
|
Название |
Описание |
|
type |
Тип источника |
|
data |
Данные источника |