Структура таблиц
Допустимые поля
Название | Описание | Чтение | Запись* | Сортировка | Фильтрация |
---|---|---|---|---|---|
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 |
![]()
Сообщение не промодерировано, возможны ошибки и неточности.
|
REAL_STATUS в текущей версии не возвращается
при получении данных поля возвращаются в виде не START_DATE_PLAN а в startDatePlan причем если их получить через tasks.task.getFields.json перечень возвращается в старом формате документация не актуальна |
![]()
Сергей Жидков
| ||
А чтобы связать задачу с компанией, при создании задачи добавить:
Это свяжет задачу с компанией с ID 269 | ||
![]()
Антон Долганин
| ||
| ||
![]()
Антон Долганин
| ||
Пример использования поля UF_CRM_TASK при добавлении задачи - в массив полей добавить:
Это свяжет задачу с контактом CRM с ID=2777 | ||
© «Битрикс», 2001-2022, «1С-Битрикс», 2022
Пользовательские комментарии
Мы будем рады, если разработчики добавят свои комментарии по практическому использованию методов системы.Для этого нужно всего лишь авторизоваться на сайте
Но помните, что Пользовательские комментарии, несмотря на модерацию, не являются официальной документацией. Ответственность за их использование несет сам пользователь.
Также Пользовательские комментарии не являются местом для обсуждения функционала. По подобным вопросам обращайтесь на форумы.