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

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

Название	Описание	Чтение	Запись*	Сортировка	Фильтрация
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 Sergey Andreev 04.11.2021 16:43:21 Сообщение не промодерировано, возможны ошибки и неточности.
REAL_STATUS в текущей версии не возвращается при получении данных поля возвращаются в виде не START_DATE_PLAN а в startDatePlan причем если их получить через tasks.task.getFields.json перечень возвращается в старом формате документация не актуальна

Сергей Жидков 15.12.2020 14:33:59

А чтобы связать задачу с компанией, при создании задачи добавить:

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

Это свяжет задачу с компанией с ID 269

Антон Долганин 03.05.2016 07:08:34

Цитата
При записи можно использовать константы CTasks::STATE_xxx

Task statuses: 1 - New, 2 - Pending (Accepted), 3 - In Progress, 4 - Supposedly completed, 5 - Completed, 6 - Deferred, 7 - Declined

Антон Долганин 27.11.2015 20:56:10

Пример использования поля UF_CRM_TASK при добавлении задачи - в массив полей добавить:

Код
'UF_CRM_TASK' => array('C_2777'),

Это свяжет задачу с контактом CRM с ID=2777

Наверх