ПланФикс API task.changeWorkers: различия между версиями

Материал из Planfix
Перейти к: навигация, поиск
Нет описания правки
Строка 73: Строка 73:
== Перейти ==
== Перейти ==
*[[ПланФикс API:Задачи]]
*[[ПланФикс API:Задачи]]
*[[Коды ошибок]]
*[[Список функций]]
*[[Список функций]]

Версия от 12:49, 27 октября 2010

Функция задает новый список исполнителей задачи. Формат вызова функции:

<?xml version="1.0" encoding="UTF-8"?>
<request method="task.changeWorkers">
  <account></account>
  <sid></sid>
  <task>
    <id></id>
  </task>
  <workers>
    <users>
      <id></id>
      <id></id>
      <!-- ... -->
    </users>
    <groups>
      <id></id>
      <id></id>
      <!-- ... -->
    </groups>
  </workers>
  <signature></signature>
</request>
Название Тип Значение Примечание
task.id int идентификатор задачи
workers корневой элемент
workers.users список пользователей, которым поставлена задача
workers.users.id int идентификатор пользователя
workers.groups список групп, которым поставлена задача
workers.groups.id int идентификатор группы
signature string(32) подпись

Важно понимать, что необходимо посылать полный список исполнителей, сервер автоматически рассчитает кого необходимо удалить, а кого добавить, и кого необходимо оставить.


Ответ:

<?xml version="1.0" encoding="UTF-8"?>
<response status="ok">
  <task>
    <id></id>
  </task>
</response>
Название Тип Значение Примечание
task.id int идентификатор задачи


В противном случае будет возвращен ответ с ошибкой:

<?xml version="1.0" encoding="UTF-8"?>
<response status="error">
  <code></code>
</response>


Перейти