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

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

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

Название Описание Чтение Запись* Сортировка Фильтрация
TITLE Название задачи. ++++
DESCRIPTION Описание задачи. ++
DEADLINE Крайний срок. +++
START_DATE_PLAN Плановая дата начала. ++++
END_DATE_PLAN Плановая дата завершения. +++
PRIORITY Приоритет. ++++
ACCOMPLICES Соисполнители (идентификаторы пользователей). ++
ACCOMPLICE Соисполнители (поле используется для фильтрации). +
AUDITORS Наблюдатели (идентификаторы пользователей). ++
AUDITOR Наблюдатели (поле используется для фильтрации). +
TAGS Теги (при добавлении - просто массив тегов в виде текста).
CTasks::GetList() не возвращает поля тегов. CTaskItem::getInstance()->getTags() возвращает массив имен тегов.
++
TAG Теги (поле используется для фильтрации). +
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 или minutes. ++
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 Идентификатор шаблона, на основе которого была автоматически создана задача. Для некоторых старых задач может быть не установлен. +
MULTITASK Флаг, означающий, что задача была создана для нескольких ответственных. +
ONLY_ROOT_TASKS Поле, позволяющее выбирать только те задачи, у которых либо нет родительской задачи, либо есть, но к этой родительской задаче мы не имеем доступа. +
MATCH_WORK_TIME Флаг, который показывает, что даты исполнения и крайний срок должны всегда устанавливаться в рабочее время. ++++

Примечание: данные поля относятся к методам task.item.*.


Также возможно фильтрация и сортировка по пользовательским полям, в частности:

Название Описание Чтение Запись*
UF_TASK_WEBDAV_FILES Список идентификаторов закрепленных за задачами файлов. ++

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



Поля даты/времени, которые читаются/записываются в формате ISO 8601

Название
DEADLINE
START_DATE_PLAN
END_DATE_PLAN
DATE_START
CREATED_DATE
CLOSED_DATE
CHANGED_DATE
STATUS_CHANGED_DATE
VIEWED_DATE


Пользовательские комментарии

Мы будем рады, если разработчики добавят свои комментарии по практическому использованию методов системы.

Для этого нужно всего лишь авторизоваться на сайте

Но помните, что Пользовательские комментарии, несмотря на модерацию, не являются официальной документацией. Ответственность за их использование несет сам пользователь.

Также Пользовательские комментарии не являются местом для обсуждения функционала. По подобным вопросам обращайтесь на форумы.
0
Антон Долганин
Цитата
При записи можно использовать константы CTasks::STATE_xxx
Task statuses: 1 - New, 2 - Pending (Accepted), 3 - In Progress, 4 - Supposedly completed, 5 - Completed, 6 - Deferred, 7 - Declined
3
Антон Долганин
Пример использования поля UF_CRM_TASK при добавлении задачи - в массив полей добавить:
Код
'UF_CRM_TASK' => array('C_2777'),

Это свяжет задачу с контактом CRM с ID=2777
© «Битрикс», 2001-2019, «1С-Битрикс», 2019
Наверх