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

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

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

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


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

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

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

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

Также Пользовательские комментарии не являются местом для обсуждения функционала. По подобным вопросам обращайтесь на форумы.
0
Александр Артамонов
Сообщение не промодерировано, возможны ошибки и неточности.
Цитата
Алексей пишет:

Здравствуйте. Подскажите, пожалуйста, как называется параметр, который ставит флаг "не завершать задачу без результата"? Поле "проконтролировать задачу после ее завершения" нашел без проблем - "TASK_CONTROL@", а с "не завершать задачу без результата" ничего нет. Версия коробочная.  
для этого в \Bitrix\Tasks\Manager\Task::add во втором параметре должен быть такой ещё типа массив
Код
'SE_PARAMETER' => [
                    [
                        'CODE' => \Bitrix\Tasks\Internals\Task\ParameterTable::PARAM_RESULT_REQUIRED,
                        'VALUE' => 'Y',
                    ],
                ]
0
Алексей
Сообщение не промодерировано, возможны ошибки и неточности.
Здравствуйте. Подскажите, пожалуйста, как называется параметр, который ставит флаг "не завершать задачу без результата"? Поле "проконтролировать задачу после ее завершения" нашел без проблем - "TASK_CONTROL@", а с "не завершать задачу без результата" ничего нет. Версия коробочная.  
0
Marat Yusupov
Сообщение не промодерировано, возможны ошибки и неточности.
Добрый день.
Где имеется информация о фактическом времени сотрудника, который он фиксирует?
1
Сергей Жидков
А чтобы связать задачу с компанией, при создании задачи добавить:

Код
'UF_CRM_TASK' => array('CO_269')

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

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