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

Текущая версия от 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>

Перейти

@@ Строка 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|| ||значение пользовательского поля задачи || Для полей типа набор задач, список сотрудников, набор записей справочника - идентификаторы через запятую в квадратных скобках. Если необходимо задать несколько значений для поля типа набор значений - ["значение_1", "значение_2"].
 |-
 |}