Tasks task list не работает

Содержание

tasks.task.list
Описание
Параметры
Примеры
Пользовательские комментарии
tasks.task.list
Function parameters
Examples
User Comments

tasks.task.list

Описание

Возвращает массив задач, каждая из которых содержит массив полей. В отличие от task.item.list параметры в запросе tasks.task.list можно указывать в любом порядке, а также можно не указывать ненужные параметры.

Для получения данных по всем задачам пользователь должен обладать админскими правами. Руководитель подразделения получит доступ только к задачам в своей ветке иерархии.

Также можно получить задачи в «Избранном», установив фильтрацию по параметру $filter[::SUBFILTER-PARAMS][FAVORITE]=Y .

Параметры

Параметр	Описание
order	Массив для сортировки результата. Массив вида . Поле для сортировки может принимать значения: ID — идентификатор задачи; TITLE — название задачи; TIME_SPENT_IN_LOGS — затраченное время из истории изменений; DATE_START — дата старта; CREATED_DATE — дата создания; CHANGED_DATE — дата последнего изменения; CLOSED_DATE — дата завершения; START_DATE_PLAN — плановое начало; END_DATE_PLAN — плановое завершение; DEADLINE — крайний срок; REAL_STATUS — статус задачи. Константы отражающие статусы задач: STATE_NEW = 1; STATE_PENDING = 2; STATE_IN_PROGRESS = 3; STATE_SUPPOSEDLY_COMPLETED = 4; STATE_COMPLETED = 5; STATE_DEFERRED = 6; STATE_DECLINED = 7; STATUS_COMPLETE — флаг завершенности задачи; PRIORITY — приоритет; MARK — оценка; CREATED_BY_LAST_NAME — постановщик; RESPONSIBLE_LAST_NAME — ответственный; GROUP_ID — рабочая группа. TIME_ESTIMATE — затраченное время; ALLOW_CHANGE_DEADLINE — флаг «Разрешить ответственному менять крайний срок»; ALLOW_TIME_TRACKING — флаг включения учета затраченного времени по задаче; MATCH_WORK_TIME — пропустить выходные дни; FAVORITE — Избранное; SORTING — индекс сортировки; MESSAGE_ID — идентификатор поискового индекса;

Параметр

Описание

order

Массив для сортировки результата. Массив вида .
Поле для сортировки может принимать значения:

ID — идентификатор задачи;

TITLE — название задачи;

TIME_SPENT_IN_LOGS — затраченное время из истории изменений;

DATE_START — дата старта;

CREATED_DATE — дата создания;

CHANGED_DATE — дата последнего изменения;

CLOSED_DATE — дата завершения;

START_DATE_PLAN — плановое начало;

END_DATE_PLAN — плановое завершение;

DEADLINE — крайний срок;

REAL_STATUS — статус задачи. Константы отражающие статусы задач:

STATE_NEW = 1;

STATE_PENDING = 2;

STATE_IN_PROGRESS = 3;

STATE_SUPPOSEDLY_COMPLETED = 4;

STATE_COMPLETED = 5;

STATE_DEFERRED = 6;

STATE_DECLINED = 7;

STATUS_COMPLETE — флаг завершенности задачи;

PRIORITY — приоритет;

MARK — оценка;

CREATED_BY_LAST_NAME — постановщик;

RESPONSIBLE_LAST_NAME — ответственный;

GROUP_ID — рабочая группа.

TIME_ESTIMATE — затраченное время;

ALLOW_CHANGE_DEADLINE — флаг «Разрешить ответственному менять крайний срок»;

ALLOW_TIME_TRACKING — флаг включения учета затраченного времени по задаче;

MATCH_WORK_TIME — пропустить выходные дни;

FAVORITE — Избранное;

SORTING — индекс сортировки;

MESSAGE_ID — идентификатор поискового индекса;

Направление сортировки может принимать значения:

asc — по возрастанию;
desc — по убыванию;

Необязательный. По умолчанию фильтруется по убыванию идентификатора задачи. filter Массив вида . Фильтруемое поле может принимать значения:

Цитата
Николай Власов пишет: При формировании задачи, есть поле «Учет времени» — «Время для выполнения задачи». Подскажите пожалуйста, каким методом можно получить значение этого поля?

Цитата
Сергей Коваленко пишет: как реализовать вывод больше 50

Цитата
Андрей пишет: Подскажите, пожалуйста: как в вебхуке в GET-запросе указать фильтрацию по дате?

Parameter	Description
ORDER	Array for sorting of result. Array of the type . Field for sorting can have the following values: ID — task ID; TITLE — task name; TIME_SPENT_IN_LOGS — time spent indicated in logs; DATE_START — start date; CREATED_DATE — date when created; CHANGED_DATE — date when task was modified last; CLOSED_DATE — date closed; START_DATE_PLAN — plan start date; END_DATE_PLAN — plan finish date; DEADLINE — deadline; REAL_STATUS — task status. Constants that reflect task statuses: STATE_NEW = 1; STATE_PENDING = 2; STATE_IN_PROGRESS = 3; STATE_SUPPOSEDLY_COMPLETED = 4; STATE_COMPLETED = 5; STATE_DEFERRED = 6; STATE_DECLINED = 7; STATUS_COMPLETE — task complete flag; PRIORITY — priority; MARK — evaluation; CREATED_BY_LAST_NAME — task created by; RESPONSIBLE_LAST_NAME — last name of the task responsible user; GROUP_ID — workgroup. TIME_ESTIMATE — time spent on task; ALLOW_CHANGE_DEADLINE — flag «Allow for responsible user to change deadline»; ALLOW_TIME_TRACKING — flag enabling task time tracking; MATCH_WORK_TIME — skip weekends; FAVORITE — favourite; SORTING — sorting index; MESSAGE_ID — search index ID;

ID — идентификатор задачи;

PARENT_ID — идентификатор родительской задачи;

GROUP_ID — идентификатор рабочей группы;

CREATED_BY — постановщик;

STATUS_CHANGED_BY — пользователь, последним изменивший статус задачи;

PRIORITY — приоритет;

FORUM_TOPIC_ID — идентификатор темы форума;

RESPONSIBLE_ID — ответственный;

TITLE — название задачи (можно искать по шаблону [%_]) ;

TAG — тэг;

REAL_STATUS — статус задачи. Константы отражающие статусы задач:

STATE_NEW = 1;

STATE_PENDING = 2;

STATE_IN_PROGRESS = 3;

STATE_SUPPOSEDLY_COMPLETED = 4;

STATE_COMPLETED = 5;

STATE_DEFERRED = 6;

STATE_DECLINED = 7;

STATUS — статус для сортировки. Аналогичен REAL_STATUS, но имеет дополнительно три мета-статуса:

-3 — задача почти просрочена;

-2 — не просмотренная задача;

-1 — просроченная задача.

MARK — оценка;

SITE_ID — идентификатор сайта;

ADD_IN_REPORT — задача в отчете (Y|N);

DATE_START — дата начала выполнения;

DEADLINE — крайний срок;

CREATED_DATE — дата создания;

CLOSED_DATE — дата завершения;

CHANGED_DATE — дата последнего изменения;

ACCOMPLICE — идентификатор соисполнителя;

AUDITOR — идентификатор наблюдателя;

DEPENDS_ON — идентификатор предыдущей задачи;

ONLY_ROOT_TASKS — только задачи, которые не являются подзадачами (корневые задачи), а также подзадачи родительской задачи, к которой текущий пользователь доступа не имеет (Y|N).

STAGE_ID — стадия;

Перед названием фильтруемого поля может указать тип фильтрации:

«!» — не равно

» » — больше

«>=» — больше либо равно

«значения фильтра» — одиночное значение или массив.

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

ID — идентификатор задачи;

PARENT_ID — идентификатор родительской задачи;

TITLE — название задачи;

DESCRIPTION — описание;

MARK — оценка;

PRIORITY — приоритет:

0 — низкий;

1 — средний;

2 — высокий.

STATUS — статус;

MULTITASK — множественная задача;

NOT_VIEWED — непросмотренная задача;

REPLICATE — повторяемая задача;

GROUP_ID — рабочая группа.

STAGE_ID — стадия;

CREATED_BY — постановщик;

CREATED_DATE — дата создания;

RESPONSIBLE_ID — исполнитель;

ACCOMPLICES — идентификатор соисполнителя;

AUDITORS — идентификатор аудитора;

CHANGED_BY — кем изменена задача;

CHANGED_DATE — дата изменения;

STATUS_CHANGED_DATE — кто изменил статус;

CLOSED_BY — кто закрыл задачу;

CLOSED_DATE — дата закрытия задачи;

DATE_START — дата начала;

DEADLINE — крайний срок;

START_DATE_PLAN — плановое начало;

END_DATE_PLAN — плановое завершение;

GUID — GUID (статистически уникальный 128-битный идентификатор);

XML_ID — внешний код;

COMMENTS_COUNT — количество комментариев;

NEW_COMMENTS_COUNT — количество новых комментариев;

TASK_CONTROL — принять в работу;

ADD_IN_REPORT — добавить в отчет;

FORKED_BY_TEMPLATE_ID — создано из шаблона;

TIME_ESTIMATE — затраченное время;

TIME_SPENT_IN_LOGS — затраченное время из истории изменений;

MATCH_WORK_TIME — пропустить выходные дни;

FORUM_TOPIC_ID — идентификатор темы форума;

FORUM_ID — идентификатор форума;

SITE_ID — идентификатор сайта;

SUBORDINATE — задача подчиненного;

FAVORITE — Избранное;

VIEWED_DATE — дата последнего просмотра;

SORTING — индекс сортировки;

DURATION_PLAN — затрачено (план);

DURATION_FACT — затрачено (фактически);

DURATION_TYPE — тип единицы измерения в планируемой длительности: days, hours или minutes

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

Список полей можно уточнить, отправив запрос tasks.task.getFields.
limit Число записей. Параметр указывается, если нужно получить число записей более значения по умолчанию (50). Все записи одним запросом вернуть нет возможности, это ограничение всех методов REST API. Вы можете несколькими запросами по 50 записей в ответе получить все лиды. Для этого просто передавайте параметр start со значением, кратным 50. Пример:
Примеры

Вывод всех задач с названием «task for test», отбор по полям ID , TITLE , STATUS , сортировка по полю ID (сортировка по возрастанию):

Вывод всех неповторяющихся задач, добавленных в «Избранное», у которых статус больше 2:

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

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

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

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

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

Добрый день,
По какому полю можно определить к какой сделке относится задача?

з.ы. у вас опечатка

DURATION_TYPE — привязка к элементам CRM;

Тип единицы измерения в планируемой длительности: days, hours или minutes.

Цитата

Николай Власов пишет:
При формировании задачи, есть поле «Учет времени» — «Время для выполнения задачи».
Подскажите пожалуйста, каким методом можно получить значение этого поля?

Если нужно выбрать все задачи компании (7658 — ID компании)

Цитата

Сергей Коваленко пишет:
как реализовать вывод больше 50

Надо получить все порции, вот пример на JS:

Цитата

Андрей пишет:
Подскажите, пожалуйста: как в вебхуке в GET-запросе указать фильтрацию по дате?

$appParams = array(
«filter» => array(‘>=CREATED_DATE’ => ‘01.09.2019’)
);

Источник

tasks.task.list

Returns array of tasks, each containing array of fields. In contrast to task.item.list, parameters of the tasks.task.list query can be specified in any sequence, as well as skip unnecessary parameters.

Also, tasks in «Favourites» can be retrieved via filtering by the parameter $filter[::SUBFILTER-PARAMS][FAVORITE]=Y .

Function parameters

Parameter Description

ORDER Array for sorting of result. Array of the type .
Field for sorting can have the following values:

ID — task ID;

TITLE — task name;

TIME_SPENT_IN_LOGS — time spent indicated in logs;

DATE_START — start date;

CREATED_DATE — date when created;

CHANGED_DATE — date when task was modified last;

CLOSED_DATE — date closed;

START_DATE_PLAN — plan start date;

END_DATE_PLAN — plan finish date;

DEADLINE — deadline;

REAL_STATUS — task status. Constants that reflect task statuses:

STATE_NEW = 1;

STATE_PENDING = 2;

STATE_IN_PROGRESS = 3;

STATE_SUPPOSEDLY_COMPLETED = 4;

STATE_COMPLETED = 5;

STATE_DEFERRED = 6;

STATE_DECLINED = 7;

STATUS_COMPLETE — task complete flag;

PRIORITY — priority;

MARK — evaluation;

CREATED_BY_LAST_NAME — task created by;

RESPONSIBLE_LAST_NAME — last name of the task responsible user;

GROUP_ID — workgroup.

TIME_ESTIMATE — time spent on task;

ALLOW_CHANGE_DEADLINE — flag «Allow for responsible user to change deadline»;

ALLOW_TIME_TRACKING — flag enabling task time tracking;

MATCH_WORK_TIME — skip weekends;

FAVORITE — favourite;

SORTING — sorting index;

MESSAGE_ID — search index ID;

Direction of sorting can have the following values:

asc — by ascension;

desc — by descension;

Optional. By default, filtering is performed by descension of task ID. FILTER Array type . Filtered field can have the following values:

ID — task ID;

PARENT_ID — parent task ID;

GROUP_ID — workgroup ID;

CREATED_BY — creator;

STATUS_CHANGED_BY — user who was the last to modify task status;

PRIORITY — priority;

FORUM_TOPIC_ID — forum topic ID;

RESPONSIBLE_ID — responsible;

TITLE — task name (can be searched by template [%_]) ;

TAG — tag;

REAL_STATUS — task status. Constants that reflect task statuses:

STATE_NEW = 1;

STATE_PENDING = 2;

STATE_IN_PROGRESS = 3;

STATE_SUPPOSEDLY_COMPLETED = 4;

STATE_COMPLETED = 5;

STATE_DEFERRED = 6;

STATE_DECLINED = 7;

STATUS — status for sorting. Similar to REAL_STATUS, but additionally has three meta-statuses:

-3 — task almost overdue;

-2 — task not viewed;

-1 — overdue task.

MARK — evaluation;

SITE_ID — site ID;

ADD_IN_REPORT — task in report (Y|N);

DATE_START — date when task started;

DEADLINE — deadline;

CREATED_DATE — date of creation;

CLOSED_DATE — date of completion;

CHANGED_DATE — date of last change;

ACCOMPLICE — observer ID;

AUDITOR — auditor ID;

DEPENDS_ON — previous task ID;

ONLY_ROOT_TASKS — root tasks only (not subtasks) as well as subtasks of parent task to which current user does not have access to (Y|N).

Type of filtration can be specified in front of the name of filtered field:

«!» — not equal

» » — more

«>=» — more or equal

«filter value» — single value or array.

Optional. Records are not filtered by default. SELECT Array of fields for records to be returned by the method. Only the required fields must be specified.

Sorting field can have the following values:

ID — task ID;

PARENT_ID — parent task ID;

TITLE — task name;

DESCRIPTION — description;

MARK — evaluation;

PRIORITY — priority:

0 — low;

1 — medium;

2 — high.

STATUS — status;

MULTITASK — multiple task;

NOT_VIEWED — task not viewed;

REPLICATE — recurring task;

GROUP_ID — workgroup.

STAGE_ID — stage;

CREATED_BY — creator;

CREATED_DATE — date of creation;

RESPONSIBLE_ID — responsible;

ACCOMPLICE — participant ID;

AUDITOR — auditor ID;

CHANGED_BY — who modified task;

CHANGED_DATE — date when modified;

STATUS_CHANGED_DATE — who modified task;

CLOSED_BY — who closed task;

CLOSED_DATE — date when task is closed;

DATE_START — start date;

DEADLINE — deadline;

START_DATE_PLAN — planned start;

END_DATE_PLAN — planned completion date;

GUID — GUID (statistically unique 128-byte ID);

XML_ID — external code;

COMMENTS_COUNT — number of comments;

NEW_COMMENTS_COUNT — number of new comments;

TASK_CONTROL — task control;

ADD_IN_REPORT — add to report;

FORKED_BY_TEMPLATE_ID — created from template;

TIME_ESTIMATE — estimated time;

TIME_SPENT_IN_LOGS — estimated time from history log;

MATCH_WORK_TIME — skip weekends;

FORUM_TOPIC_ID — forum topic ID;

FORUM_ID — forum ID;

SITE_ID — site ID;

SUBORDINATE — task of subordinate;

FAVORITE — Favourites;

VIEWED_DATE — date when viewed last;

SORTING — sorting index;

DURATION_PLAN — duration (plan);

DURATION_FACT — duration (actual);

DURATION_TYPE — binded to CRM elements;

Optional. All the main tabs fields will be returned by default. List of fields can be clarified by sending tasks.task.getFields request.
Examples

Print all tasks with the name «task for test», sorting by fields ID , TITLE , STATUS (sorting by ascension):

Printing all Non-recurring tasks, added to «Favourites» with status higher than 2:

User Comments

User comments are not part of official documentation. Use information provided by other users in the comments at your own risk.

The User Comments section is not to be used as a feature discussion board. Only registered users can post comments. Your comment will be visible once it has been approved by the moderator.

Источник

Читайте также: Ivsweb exe не работает