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

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

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

Название Описание Чтение Запись* Сортировка Фильтрация
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 Причина отклонения задачи. ++
STATUS Cтатус задачи. ++++
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


© «Битрикс», 2001-2024, «1С-Битрикс», 2024