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

Материал из Planfix
Версия от 11:07, 23 августа 2010; Seva (обсуждение | вклад) (Новая страница: «Функция задает '''новый''' список исполнителей задачи. Формат вызова функции: <source lang="xml"> <?xml ...»)
(разн.) ← Предыдущая версия | Текущая версия (разн.) | Следующая версия → (разн.)
Перейти к: навигация, поиск

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

<?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 неизвестная ошибка


Перейти