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

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

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

Название Описание Чтение Запись* Сортировка Фильтрация
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
Наверх