Описание и параметры
int
CTasks::Add(
array arFields,
array arParams = array()
);
Метод добавляет новую задачу.
Параметры метода
| Параметр | Описание | С версии |
| arFields | Массив Array("поле"=>"значение", ...). Содержит значения всех полей задачи. Поля:
- TITLE - название задачи (можно искать по шаблону
[%_] ;) ;
- DESCRIPTION - описание задачи;
- DEADLINE - крайний срок;
- START_DATE_PLAN - плановая дата начала;
- END_DATE_PLAN - плановая дата завершения;
- PRIORITY - приоритет. Поле может принимать значения: [1] - Обычная [2] - Важная;
- ACCOMPLICES - массив идентификаторов соисполнителей;
- AUDITORS - массив идентификаторов наблюдателей;
- TAGS - теги;
- ALLOW_CHANGE_DEADLINE - флаг "Разрешить исполнителю (ответственному) менять крайний срок";
- TASK_CONTROL - флаг "Принять работу после завершения задачи";
- PARENT_ID - идентификатор родительской задачи;
- DEPENDS_ON - идентификатор предыдущей задачи;
- GROUP_ID - идентификатор рабочей группы;
- RESPONSIBLE_ID - идентификатор исполнителя (ответственного);
- TIME_ESTIMATE - плановые трудозатраты;
- CREATED_BY - идентификатор постановщика;
- DECLINE_REASON - причина отклонения задачи;
- STATUS - мета-статус задачи;
- DURATION_PLAN - планируемая длительность в часах или днях;
- DURATION_TYPE - тип единицы измерения в планируемой длительности: days или hours;
- MARK - оценка по задаче (возможные значения P (положительная) и N (отрицательная));
- ALLOW_TIME_TRACKING - флаг включения учета затраченного времени по задаче;
- ADD_IN_REPORT - флаг включения задачи в отчет по эффективности;
- FORUM_ID - идентификатор форума, в котором хранятся комментарии к задаче;
- FORUM_TOPIC_ID - идентификатор темы форума, в котором хранятся комментарии к задаче;
- SITE_ID - идентификатор сайта. По умолчанию в это поле записывается идентификатор сайта, на котором создается задача;
- MATCH_WORK_TIME - флаг, который показывает, что даты исполнения и крайний срок должны всегда устанавливаться в рабочее время;
| |
| arParams | Массив дополнительных параметров. Необязательный. | 11.5.4 |
Возвращаемое значение
Метод возвращает идентификатор добавленной задачи, если добавление прошло успешно. При возникновении ошибки метод вернет false, а в исключениях будут содержаться ошибки.
Примеры использования
<?
if (CModule::IncludeModule("tasks"))
{
$arFields = Array(
"TITLE" => "Task title",
"DESCRIPTION" => "Task description",
"RESPONSIBLE_ID" => 2,
"GROUP_ID" => 3
);
$obTask = new CTasks;
$ID = $obTask->Add($arFields);
$success = ($ID>0);
if($success)
{
echo "Ok!";
}
else
{
if($e = $APPLICATION->GetException())
echo "Error: ".$e->GetString();
}
}?>
//Создание задачи с высоким приоритетом
{
$arFields = Array("TITLE" => "High priority task",
"DESCRIPTION" => "Task description",
"RESPONSIBLE_ID" => 3,
"CREATED_BY" => 1,
"PRIORITY" => 2 // 2 соответствует высокому приоритету
);
$obTask = new CTasks;
$obTask->Add($arFields);
}
Пользовательские комментарии
Помните, что Пользовательские комментарии, несмотря на модерацию, не являются официальной документацией. Ответственность за их использование несет сам пользователь.Также Пользовательские комментарии не являются местом для обсуждения функционала. По подобным вопросам обращайтесь на форумы.