ПланФикс API handbook.addRecord — различия между версиями
Материал из ПланФикс
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>