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

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-2024, «1С-Битрикс», 2024