Update

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

bool
CTasks::Update(
	ID,
	array arFields
);

Метод изменяет параметры задачи с идентификатором ID.

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

Параметр	Описание
ID	Идентификатор изменяемой задачи
arFields	Массив Array("поле"=>"значение", ...). Содержит значения всех полей задачи. Обязательные поля должны быть заполнены.

Возвращаемое значение

Метод возвращает true, если изменение прошло успешно, при возникновении ошибки метод вернет false. При возникновении ошибки в исключениях будет содержаться текст ошибки.

Примеры использования

<?
if (CModule::IncludeModule("tasks"))
{
	$arFields = Array(
		"TITLE" => "New task title",
		"DESCRIPTION" => "New description"
	);
	$ID = 1;
	$obTask = new CTasks;
	$success = $obTask->Update($ID, $arFields);
	if($success)
	{
		echo "Ok!";
	
	}
	else
	{
		if($e = $APPLICATION->GetException())
			echo "Error: ".$e->GetString();
	}
}?>

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

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

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

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

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

Александр Басыров 18.12.2013 13:15:34

В третьем параметре передается массив опций. Опция USER_ID задает пользователя, от имени которого выполняется действие. Однако, CTasks - это устаревшее API и рекомендуется его не использовать более. На замену ему пришел класс CTaskItem. Код выше можно переписать следующим образом:

Код

CModule::IncludeModule('tasks');  
$arFields = array('STATUS' => CTasks::STATE_DEFERRED);      // 6 - CTasks::STATE_DEFERRED
$ID = 13622;
$oTaskItem = CTaskItem::getInstance($ID, 53);   // 53 - это USER_ID, от имени которого будет сделано действие и проверены права
$oTaskItem->update($arFields);

Виталий Ракитин 20.11.2013 11:38:50

Для того чтобы изменить задачу от имени другого пользователя, необходимо в качестве третьего параметра указать array('USER_ID' => ИД_пользователя)

Код
CModule::IncludeModule('tasks'); $arFields = array('STATUS' => 6); $ID = 13622; $obTask = new CTasks; $success = $obTask->Update($ID, $arFields, array('USER_ID' => 53));

Наверх