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

Add

Описание и параметры

int
CTasks::Add(
 array arFields,
 array arParams = array()
);

Метод добавляет новую задачу.

Параметры метода

Параметр Описание С версии
arFields Массив Array("поле"=>"значение", ...). Содержит значения всех полей задачи. Поля:
  • TITLE - название задачи (можно искать по шаблону [%_] ;) ;
  • DESCRIPTION - описание задачи;
  • DEADLINE - крайний срок;
  • START_DATE_PLAN - плановая дата начала;
  • END_DATE_PLAN - плановая дата завершения;
  • PRIORITY - приоритет. Поле может принимать значения: [0] - низкий приоритет, [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);
}


© «Битрикс», 2001-2021, «1С-Битрикс», 2021
Наверх