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

task.commentitem.getlist

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

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

Возвращает список комментариев к задаче.

Пример

// Получить все комментарии для задачи ID=1 с восходящей сортировкой по ID и фильтрацией по AUTHOR_ID

BX24.callMethod(
	'task.commentitem.getlist',
	[1, {'ID': 'asc'}, {'>AUTHOR_ID': 2}],
	function(result){
		console.info(result.data());
		console.log(result);
	}
);

Параметры

ПараметрОписание
TASKID Идентификатор задачи. Обязательный параметр.
ORDER Массив для сортировки результата. Поле для сортировки может принимать значения:
  • ID - идентификатор комментария;
  • AUTHOR_ID - идентификатор автора комментария;
  • AUTHOR_NAME - имя автора;
  • AUTHOR_EMAIL - почтовый адрес автора;
  • POST_DATE - дата публикации комментария.
Направление сортировки может принимать значения:
  • asc - по возрастанию;
  • desc - по убыванию;
Необязательный. По умолчанию фильтруется по убыванию идентификатора комментария.
FILTER Массив вида {"фильтруемое_поле": "значение фильтра" [, ...]}. Фильтруемое поле может принимать значения:
  • ID - идентификатор комментария;
  • AUTHOR_ID - идентификатор автора комментария;
  • AUTHOR_NAME - имя автора;
  • POST_DATE - дата публикации комментария.
Перед названием фильтруемого поля может указать тип фильтрации:
  • "!" - не равно;
  • "<" - меньше;
  • "<=" - меньше либо равно;
  • ">" - больше;
  • ">=" - больше либо равно.
"значения фильтра" - одиночное значение или массив.

Необязательный. По умолчанию записи не фильтруются.

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



© «Битрикс», 2001-2024, «1С-Битрикс», 2024