ПланФикс API task.changeWorkers: различия между версиями
Материал из Planfix
Seva (обсуждение | вклад) (Новая страница: «Функция задает '''новый''' список исполнителей задачи. Формат вызова функции: <source lang="xml"> <?xml ...») |
Seva (обсуждение | вклад) Нет описания правки |
||
(не показаны 4 промежуточные версии 2 участников) | |||
Строка 1: | Строка 1: | ||
Функция | Функция используется для изменения списка исполнителей задачи. Формат вызова функции: | ||
<source lang="xml"> | <source lang="xml"> | ||
<?xml version="1.0" encoding="UTF-8"?> | <?xml version="1.0" encoding="UTF-8"?> | ||
Строка 7: | Строка 7: | ||
<task> | <task> | ||
<id></id> | <id></id> | ||
<workers> | |||
<addUsers> | |||
<id></id> | |||
<id></id> | |||
<!-- ... --> | |||
</addUsers> | |||
<addGroups> | |||
<id></id> | |||
<id></id> | |||
<!-- ... --> | |||
</addGroups> | |||
<delUsers> | |||
<id></id> | |||
<id></id> | |||
<!-- ... --> | |||
</delUsers> | |||
<delGroups> | |||
<id></id> | |||
<id></id> | |||
<!-- ... --> | |||
</delGroups> | |||
</workers> | |||
</task> | </task> | ||
<signature></signature> | <signature></signature> | ||
</request> | </request> | ||
Строка 28: | Строка 38: | ||
|task.id ||int || идентификатор задачи|| | |task.id ||int || идентификатор задачи|| | ||
|- | |- | ||
|workers || || корневой элемент | |workers || ||корневой элемент списка исполнителей задачи || | ||
|- | |- | ||
|workers. | |workers.addUsers || || корневой элемент списка пользователей, которые подключаются к задаче || | ||
|- | |- | ||
|workers. | |workers.addUsers.id ||int ||идентификатор пользователя, который подключается к задаче || | ||
|- | |- | ||
|workers. | |workers.addGroups || ||корневой элемент списка групп, которые подключаются к задаче|| | ||
|- | |- | ||
|workers. | |workers.addGroups.id ||int || идентификатор группы|| | ||
|- | |||
|workers.delUsers || || корневой элемент списка пользователей, которые удаляются из списка исполнителей || | |||
|- | |||
|workers.delUsers.id ||int ||идентификатор пользователя, который удаляется из списка исполнителей || | |||
|- | |||
|workers.delGroups || ||корневой элемент списка групп, которые удаляются из списка исполнителей || | |||
|- | |||
|workers.delGroups.id ||int || идентификатор группы|| | |||
|- | |- | ||
|signature ||string(32) ||подпись || | |signature ||string(32) ||подпись || | ||
|- | |- | ||
|} | |} | ||
Строка 68: | Строка 85: | ||
</response> | </response> | ||
</source> | </source> | ||
== Перейти == | == Перейти == | ||
*[[ПланФикс API:Задачи]] | *[[ПланФикс API:Задачи]] | ||
*[[Коды ошибок]] | |||
*[[Список функций]] |
Текущая версия от 08:07, 28 апреля 2021
Функция используется для изменения списка исполнителей задачи. Формат вызова функции:
<?xml version="1.0" encoding="UTF-8"?>
<request method="task.changeWorkers">
<account></account>
<sid></sid>
<task>
<id></id>
<workers>
<addUsers>
<id></id>
<id></id>
<!-- ... -->
</addUsers>
<addGroups>
<id></id>
<id></id>
<!-- ... -->
</addGroups>
<delUsers>
<id></id>
<id></id>
<!-- ... -->
</delUsers>
<delGroups>
<id></id>
<id></id>
<!-- ... -->
</delGroups>
</workers>
</task>
<signature></signature>
</request>
Название | Тип | Значение | Примечание |
---|---|---|---|
task.id | int | идентификатор задачи | |
workers | корневой элемент списка исполнителей задачи | ||
workers.addUsers | корневой элемент списка пользователей, которые подключаются к задаче | ||
workers.addUsers.id | int | идентификатор пользователя, который подключается к задаче | |
workers.addGroups | корневой элемент списка групп, которые подключаются к задаче | ||
workers.addGroups.id | int | идентификатор группы | |
workers.delUsers | корневой элемент списка пользователей, которые удаляются из списка исполнителей | ||
workers.delUsers.id | int | идентификатор пользователя, который удаляется из списка исполнителей | |
workers.delGroups | корневой элемент списка групп, которые удаляются из списка исполнителей | ||
workers.delGroups.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>