ПланФикс API task.changeWorkers

Материал из Planfix
Перейти к: навигация, поиск

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

<?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>


Перейти