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

Текущая версия на 16:56, 7 марта 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		значение пользовательского поля задачи	(для полей типа набор задач, список сотрудников, набор записей справочника - идентификаторы через запятую в квадратных скобках)

Ответ при удачном выполнении функции:

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

Перейти

@@ Строка 3: / Строка 3: @@
 |titlemode=append
 |keywords=планфикс, задачи, апи, api
-|description=ПланФикс API task.update
+|description=ПланФикс API task.updateCustomData
 }}
 Функция обновления пользовательских полей задачи. Может использоваться, если у пользователя нет прав на изменение задачи и поэтому использовать функцию task.update он не может, но при этом есть права на изменение пользовательских полей.
 Формат запроса:
 <source lang="xml">
 <?xml version="1.0" encoding="UTF-8"?>
-<request method="task.update">
+<request method="task.updateCustomData">
    <account></account>
    <sid></sid>
@@ Строка 38: / Строка 39: @@
 |customData.customValue.id|| ||идентификатор пользовательского поля задачи ||
 |-
-|customData.customValue.value|| ||значение пользовательского поля задачи ||
+|customData.customValue.value|| ||значение пользовательского поля задачи || (для полей типа набор задач, список сотрудников, набор записей справочника - идентификаторы через запятую в квадратных скобках)
 |-
 |}