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

Материал из Planfix
Перейти к: навигация, поиск
(Новая страница: «Функция задает '''новый''' список исполнителей задачи. Формат вызова функции: <source lang="xml"> <?xml ...»)
 
Строка 78: Строка 78:


== Перейти ==
== Перейти ==
*[[ПланФикс API]]
*[[ПланФикс API:Задачи]]
*[[ПланФикс API:Задачи]]
*[[Список функций]]

Версия от 11:57, 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>
Значение code Расшифровка
0000 неизвестная ошибка


Перейти