Документация для разработчиков

Структура таблиц

Допустимые поля

Название Описание Чтение Запись* Сортировка Фильтрация
TITLE Название задачи. ++++
DESCRIPTION Описание задачи. ++++
DEADLINE Крайний срок. ++++
START_DATE_PLAN Плановая дата начала. ++++
END_DATE_PLAN Плановая дата завершения. ++++
PRIORITY Приоритет. Поле может принимать значения: [0] - низкий приоритет, [1] - средний, [2] - высокий. ++++
ACCOMPLICES Соисполнители (идентификаторы пользователей). ++++
AUDITORS Наблюдатели (идентификаторы пользователей). ++++
TAGS Теги (при добавлении - просто массив тегов в виде текста).
CTasks::GetList() не возвращает поля тегов. CTaskItem::getInstance()->getTags() возвращает массив имен тегов.
++++
ALLOW_CHANGE_DEADLINE Флаг "Разрешить ответственному менять крайний срок". ++++
TASK_CONTROL Флаг "Принять работу после завершения задачи". ++++
PARENT_ID Идентификатор родительской задачи. ++++
DEPENDS_ON Идентификатор предыдущей задачи. ++++
GROUP_ID Идентификатор рабочей группы. ++++
RESPONSIBLE_ID Идентификатор ответственного. ++++
TIME_ESTIMATE Плановые трудозатраты. ++++
ID Идентификатор задачи. Уникален в рамках базы данных. +++
CREATED_BY Идентификатор постановщика. ++++
DESCRIPTION_IN_BBCODE Флаг указывающий, что описание задачи хранится в BB-кодах. +++
DECLINE_REASON Причина отклонения задачи. ++++
REAL_STATUS Истинный статус задачи, который записывается через STATUS (см. константы CTasks::STATE_xxx). Только для чтения. +++
STATUS Мета-статус задачи.
При записи можно использовать константы CTasks::STATE_xxx, однако, при чтении, помимо CTasks::STATE_xxx, в результатах можно увидеть CTasks::METASTATE_xxx. То есть на самом деле статус задачи может быть CTasks::STATE_NEW, а при чтении вернется нам CTasks::METASTATE_EXPIRED (для просроченной задачи).
В случае если мы хотим узнать истинный статус задачи, следует читать поле REAL_STATUS.
++++
RESPONSIBLE_NAME Имя ответственного. +++
RESPONSIBLE_LAST_NAME Фамилия ответственного. +++
RESPONSIBLE_SECOND_NAME Отчество ответственного. +++
DATE_START Дата начала выполнения задачи. +++
DURATION_FACT Затраченное время на задачу (в минутах). +++
DURATION_PLAN Планируемая длительность в часах или днях. ++++
DURATION_TYPE Тип единицы измерения в планируемой длительности: days или hours. ++++
CREATED_BY_NAME Имя постановщика. +++
CREATED_BY_LAST_NAME Фамилия постановщика. +++
CREATED_BY_SECOND_NAME Отчество постановщика. +++
CREATED_DATE Дата создания задачи. +++
CHANGED_BY Пользователь, изменивший задачу в последний раз (идентификатор пользователя). +++
CHANGED_DATE Дата последнего изменения задачи. +++
STATUS_CHANGED_BY Пользователь, изменивший статус задачи (идентификатор пользователя). +++
STATUS_CHANGED_DATE Дата смены статуса. +++
CLOSED_BY Кем была завершена задача. +++
CLOSED_DATE Дата завершения задачи. +++
GUID Глобально-уникальный идентификатор. С приемлемым уровнем уверенности, данный идентификатор непреднамеренно никогда не будет использован для чего-то ещё даже в других базах данных. +++
MARK Оценка по задаче (возможные значения P (положительная) и N (отрицательная)). ++++
VIEWED_DATE Дата последнего просмотра задачи в публичном интерфейсе текущим пользователем (от имени которого делается запрос на получение данных задачи). +++
TIME_SPENT_IN_LOGS Затраченное время на задачу (в секундах). ++
FAVORITE Присутствие и избранном для текущего пользователя. ++
ALLOW_TIME_TRACKING Флаг включения учета затраченного времени по задаче. + + ++
ADD_IN_REPORT Флаг включения задачи в отчет по эффективности. + + ++
FORUM_ID Идентификатор форума, в котором хранятся комментарии к задаче. + + ++
FORUM_TOPIC_ID Идентификатор темы форума, в котором хранятся комментарии к задаче. + + ++
COMMENTS_COUNT Число комментариев к задаче. + ++
SITE_ID Идентификатор сайта. По умолчанию в это поле записывается идентификатор сайта, на котором создается задача. + +++
SUBORDINATE Флаг, который показывает, является ли кто-то из участников задачи подчиненным текущего пользователя. + ++
FORKED_BY_TEMPLATE_ID Идентификатор шаблона, на основе которого была создана задача. Для некоторых старых задач может быть не установлен. + ++
MATCH_WORK_TIME Флаг, который показывает, что даты исполнения и крайний срок должны всегда устанавливаться в рабочее время. ++++

Примечание: Запись и изменение полей производится согласно бизнес-логике и имеющимся правам пользователя. Т.е. зависит от роли пользователя, настроек прав на группу, иерархии, некоторых флагов в задаче (например, ALLOW_CHANGE_DEADLINE), статуса задачи.


© «Битрикс», 2001-2019, «1С-Битрикс», 2019
Наверх