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

Материал из Planfix
Перейти к: навигация, поиск
(Новая страница: «Создание записи справочника. Формат запроса: <source lang="xml"> <?xml version="1.0" encoding="UTF-8"?> <request method="han…»)
 
Нет описания правки
Строка 34: Строка 34:
|name||string ||название, если запись является группой ||
|name||string ||название, если запись является группой ||
|-
|-
|customData|| ||значения полей задачи ||
|customData|| ||значения полей ||
|-
|-
|customData.customValue.id|| ||идентификатор поля ||
|customData.customValue.id|| ||идентификатор поля ||

Версия от 10:32, 4 апреля 2018

Создание записи справочника. Формат запроса:

<?xml version="1.0" encoding="UTF-8"?>
<request method="handbook.addRecord">
  <account></account>
  <sid></sid>
  <handbook>
    <id></id>
  </handbook>
  <parentKey></parentKey>
  <isGroup></isGroup>
  <name></name>
  <customData>
    <customValue>
      <id></id>
      <value></value>
    </customValue>
    <!-- ... -->
  </customData>
  <signature></signature>
</request>
Название Тип Значение Примечание
sid string(32) ключ сесии выдается в результате прохождения аутентификации
handbook.id int идентификатор справочника
parentKey int идентификатор группы записей необязательный параметр
isGroup bool является ли запись группой
name string название, если запись является группой
customData значения полей
customData.customValue.id идентификатор поля
customData.customValue.value значение поля (для полей типа набор задач, список сотрудников, набор записей справочника - идентификаторы через запятую в квадратных скобках)

Ответ при успешном выполнении запроса:

<?xml version="1.0" encoding="UTF-8"?>
<response status="ok">
  <key></key>
</response>
Название Тип Значение Примечание
key int идентификатор записи

В противном случае будет возвращен ответ с ошибкой:

<?xml version="1.0" encoding="UTF-8"?>
<response status="error">
  <code></code>
</response>


Перейти