task.elapseditem.getlist

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

Описание

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

Параметры

Параметр	Описание
TASKID	Идентификатор задачи. Необязательный параметр.
ORDER	Массив для сортировки результата. Поле для сортировки может принимать значения: ID - идентификатор записи о затраченном времени; USER_ID - идентификатор пользователя, от имени которого была сделана запись о затраченном времени; MINUTES - затраченное время, минуты; SECONDS - затраченное время, секунды; CREATED_DATE - дата создания записи; DATE_START - дата начала; DATE_STOP - дата конца. Направление сортировки может принимать значения: asc - по возрастанию; desc - по убыванию; Необязательный. По умолчанию фильтруется по убыванию идентификатора записи о затраченном времени.
FILTER	Массив вида {"фильтруемое_поле": "значение фильтра" [, ...]}. Фильтруемое поле может принимать значения: ID - идентификатор комментария; USER_ID - идентификатор пользователя, от имени которого была сделана запись о затраченном времени; CREATED_DATE - дата создания записи; Перед названием фильтруемого поля может указать тип фильтрации: "!" - не равно; "<" - меньше; "<=" - меньше либо равно; ">" - больше; ">=" - больше либо равно. "значения фильтра" - одиночное значение или массив. Необязательный. По умолчанию записи не фильтруются.
SELECT	Массив полей записей, которые будут возвращены методом. Можно указать только те поля, которые необходимы. Если в массиве присутствует значение `"*"`, то будут возвращены все доступные поля. Значение по умолчанию - пустой массив `array()` - означает, что будут возвращены все поля основной таблицы запроса.
PARAMS	Массив для опций вызова. Элементом является массив NAV_PARAMS вида {"опция вызова": 'значение' [, ...]}, хранящий следующие опции: nPageSize - количество элементов на странице. В целях ограничения нагрузки на постраничную навигацию наложено ограничение в 50 записей. iNumPage - номер страницы при постраничной навигации.

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

Особенности ручного добавления информации о времени работы, которая было фактически выполнена несколько дней назад. В этом случае меняется значение некоторых полей:

CREATED_DATE - дата начала;
DATE_START - дата создания записи;
DATE_STOP - дата создания записи;

Примеры

// Получить все записи о затраченном времени с сортировкой по ID в нисходящем порядке. 
// Будут отфильтрованы только те записи, ID которых имеет значение меньше 50.
BX24.callMethod(
	'task.elapseditem.getlist',
	[1, {'ID': 'desc'}, {'<ID': 50}],
	function(result){
		console.info(result.data());
		console.log(result);
	}
);

Получение выборки по затраченному времени на основании общий условий фильтрации. Например, выбрать данные о трудозатратах с указанной даты:

BX24.callMethod(
	'task.elapseditem.getlist',
	[{'ID': 'desc'}, {>=CREATED_DATE': '2018-02-16'}],
	function(result){
		console.info(result.data());
		console.log(result);
	}
);

Пример для работы с php:

// Пример для работы с php
// Получение GET-запроса на выборку данных.
$appParams = array(
	"auth" => '92006f4ae0c55d400f1e6e09428af64a',
	"ORDER" => array("ID" => "DESC"),			// Сортировка по ID - по убыванию
	"FILTER" => array(">ID" => 1),				// Фильтр
	"SELECT" => array('ID', 'TASK_ID'),			// Выборка - только ID записи и задачи
	"PARAMS" => array('NAV_PARAMS' => array(	// Постраничка
		"nPageSize" => 2,						// по 2 элемента на странице
		'iNumPage' => 2							// страница номер 2
	)),
);
$appRequestUrl = 'http://test-domain.ru/rest/task.elapseditem.getlist.xml?'.http_build_query($appParams);
print(urldecode($appRequestUrl));;