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

task.checklistitem.add

Scope: task Права на выполнение: для всех

Добавление нового элемента чек-листа к задаче. Возвращает идентификатор добавленного элемента. Метод не добавляет права на задачу указанному в массиве FIELDS пользователю, как это делается через интерфейс Б24. Если у пользователя не было прав на просмотр, то появление его в чек-листе в любой роли не сделает задачу доступной.

Параметры функции

ПараметрОписание
TASKID Идентификатор задачи. Обязательный параметр.
FIELDS Массив полей элемента чек-листа (TITLE, SORT_INDEX, IS_COMPLETE). Обязательный параметр.

Внимание! Соблюдение порядка следования параметров в запросе обязательно. При его нарушении запрос будет выполнен с ошибками.

Пример

// Добавляем к задаче с ID=13 новый "выполненный" элемент чек-листа с текстом "Пункт выполнен"
BX24.callMethod(
	'task.checklistitem.add',
	[13, {'TITLE': 'Пункт выполнен', 'IS_COMPLETE': 'Y'}], 
	function(result){
		console.info(result.data());
		console.log(result);
	}
);

Для добавления пользователя к элементу чек-листа:

$fields = [
	'TITLE' => "Заголовок пункта Имя Пользователя",//$user['NAME']." ".$user['LAST_NAME'], порядок в зависимости от настроек портала.
	'IS_COMPLETE' => 'N',
	'IS_IMPORTANT' => 'N',
	'MEMBERS' => [13 => ['TYPE' => 'A']], //TYPE - роль_в_чеклисте: A - соисполнитель, U - наблюдатель
	'PARENT_ID' => '$result[0]' // для вызова в batch, иначе просто ID вышестоящего элемента
];


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

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

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

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

Также Пользовательские комментарии не являются местом для обсуждения функционала. По подобным вопросам обращайтесь на форумы.
© «Битрикс», 2001-2024, «1С-Битрикс», 2024