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

task.elapseditem.getlist

Описание

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

Параметры

ПараметрОписание
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 - номер страницы при постраничной навигации.

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

Примеры

// Получить все записи о затраченном времени с сортировкой по 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));;


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

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

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

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

Также Пользовательские комментарии не являются местом для обсуждения функционала. По подобным вопросам обращайтесь на форумы.
3
Александр Воробьев
Сообщение непромодерировано, возможны ошибки и неточности.
Доработать описание полей. Они не совсем корректны.
    Код
    CREATED_DATE - дата создания записи;DATE_START - дата начала;DATE_STOP - дата конца.

Это все выглядит правильно. Но. Если по каким либо причинам надо будет добавить руками информацию  о времени работы, которое было фактически выолнено несколько дней назад. То будет ждать сюрприз.
Эту информацию вводим на портале, штатными средствами. Указываем дату события и сколько времени потрачено. И вы этом случае эти поля будут означать совсем иное
Цитата

  • CREATED_DATE - дата начала;
  • DATE_START - дата создания записи;
  • DATE_STOP - дата создания записи;
  • © «Битрикс», 2001-2021, «1С-Битрикс», 2021
    Наверх