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

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

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

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

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

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

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

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

Также Пользовательские комментарии не являются местом для обсуждения функционала. По подобным вопросам обращайтесь на форумы.

Наверх