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

Версия 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>

Перейти

@@ Строка 34: / Строка 34: @@
 |name||string ||название, если запись является группой ||
 |-
-|customData|| ||значения полей задачи ||
+|customData|| ||значения полей ||
 |-
 |customData.customValue.id|| ||идентификатор поля ||