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

Материал из Planfix
Перейти к: навигация, поиск
Нет описания правки
Нет описания правки
 
Строка 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>

Перейти