ПланФикс API handbook.addRecord: различия между версиями
Материал из Planfix
Seva (обсуждение | вклад) Нет описания правки |
Seva (обсуждение | вклад) Нет описания правки |
||
Строка 15: | Строка 15: | ||
<id></id> | <id></id> | ||
<value></value> | <value></value> | ||
<files> | |||
<file> | |||
<name></name> | |||
<sourceType></sourceType> | |||
<otherFile> | |||
<url></url> | |||
</otherFile> | |||
<body></body> | |||
<description></description> | |||
<newversion></newversion> | |||
</file> | |||
</files> | |||
</customValue> | </customValue> | ||
<!-- ... --> | <!-- ... --> | ||
Строка 39: | Строка 51: | ||
|- | |- | ||
|customData.customValue.value|| ||значение поля || (для полей типа набор задач, список сотрудников, набор записей справочника - идентификаторы через запятую в квадратных скобках) | |customData.customValue.value|| ||значение поля || (для полей типа набор задач, список сотрудников, набор записей справочника - идентификаторы через запятую в квадратных скобках) | ||
|- | |||
|files || ||корневой элемент содержащий список сохраняемых файлов || | |||
|- | |||
|file || ||сохраняемый файл || | |||
|- | |||
|file.name ||string ||имя сохраняемого файла || | |||
|- | |||
|file.sourceType || enum||тип источника || список допустимых значений смотри в [[ПланФикс API Типы источников файла|типы источников файла]], допустимые значения FILESYSTEM и INTERNET | |||
|- | |||
|file.otherFile || ||Использовать уже существующий файл ||используется при sourceType: INTERNET | |||
|- | |||
|file.otherFile.url ||string || URL фала в Интернет ||используется только при sourceType=INTERNET | |||
|- | |||
|file.body ||string ||тело файла закодированное base64 ||используется при sourceType=FILESYSTEM | |||
|- | |||
|file.description ||string || краткое описание содержимого файла || не обязательный параметр | |||
|- | |||
|file.newversion ||boolean || если значение равно "1", при совпадении имени файла с ранее загруженным, не выдаётся ошибка, а файл загружается, как новая версия существующего || не обязательный параметр | |||
|- | |- | ||
|} | |} |
Версия от 12:24, 24 декабря 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>
<files>
<file>
<name></name>
<sourceType></sourceType>
<otherFile>
<url></url>
</otherFile>
<body></body>
<description></description>
<newversion></newversion>
</file>
</files>
</customValue>
<!-- ... -->
</customData>
<signature></signature>
</request>
Название | Тип | Значение | Примечание |
---|---|---|---|
sid | string(32) | ключ сесии | выдается в результате прохождения аутентификации |
handbook.id | int | идентификатор справочника | |
parentKey | int | идентификатор группы записей | необязательный параметр |
isGroup | bool | является ли запись группой | |
name | string | название, если запись является группой | |
customData | значения полей | ||
customData.customValue.id | идентификатор поля | ||
customData.customValue.value | значение поля | (для полей типа набор задач, список сотрудников, набор записей справочника - идентификаторы через запятую в квадратных скобках) | |
files | корневой элемент содержащий список сохраняемых файлов | ||
file | сохраняемый файл | ||
file.name | string | имя сохраняемого файла | |
file.sourceType | enum | тип источника | список допустимых значений смотри в типы источников файла, допустимые значения FILESYSTEM и INTERNET |
file.otherFile | Использовать уже существующий файл | используется при sourceType: INTERNET | |
file.otherFile.url | string | URL фала в Интернет | используется только при sourceType=INTERNET |
file.body | string | тело файла закодированное base64 | используется при sourceType=FILESYSTEM |
file.description | string | краткое описание содержимого файла | не обязательный параметр |
file.newversion | boolean | если значение равно "1", при совпадении имени файла с ранее загруженным, не выдаётся ошибка, а файл загружается, как новая версия существующего | не обязательный параметр |
Ответ при успешном выполнении запроса:
<?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>