ПланФикс API task.updateCustomData: различия между версиями
Материал из Planfix
Seva (обсуждение | вклад) Нет описания правки |
Artem (обсуждение | вклад) Нет описания правки |
||
Строка 39: | Строка 39: | ||
|customData.customValue.id|| ||идентификатор пользовательского поля задачи || | |customData.customValue.id|| ||идентификатор пользовательского поля задачи || | ||
|- | |- | ||
|customData.customValue.value|| ||значение пользовательского поля задачи || | |customData.customValue.value|| ||значение пользовательского поля задачи || Для полей типа набор задач, список сотрудников, набор записей справочника - идентификаторы через запятую в квадратных скобках. Если необходимо задать несколько значений для поля типа набор значений - ["значение_1", "значение_2"]. | ||
|- | |- | ||
|} | |} |
Текущая версия от 14:29, 13 декабря 2022
Функция обновления пользовательских полей задачи. Может использоваться, если у пользователя нет прав на изменение задачи и поэтому использовать функцию task.update он не может, но при этом есть права на изменение пользовательских полей.
Формат запроса:
<?xml version="1.0" encoding="UTF-8"?>
<request method="task.updateCustomData">
<account></account>
<sid></sid>
<task>
<id></id>
<general></general>
<customData>
<customValue>
<id></id>
<value></value>
</customValue>
<!-- ... -->
</customData>
</task>
<signature></signature>
</request>
Название | Тип | Значение | Примечание |
---|---|---|---|
id | int | идентификатор обновляемой задачи | |
general | int | номер задачи (если задан, используется вместо id) | |
customData | значения пользовательских полей задачи | ||
customData.customValue.id | идентификатор пользовательского поля задачи | ||
customData.customValue.value | значение пользовательского поля задачи | Для полей типа набор задач, список сотрудников, набор записей справочника - идентификаторы через запятую в квадратных скобках. Если необходимо задать несколько значений для поля типа набор значений - ["значение_1", "значение_2"]. |
Ответ при удачном выполнении функции:
<?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>