ПланФикс API action.add — различия между версиями
Материал из ПланФикс
Seva (обсуждение | вклад) |
Seva (обсуждение | вклад) |
||
| Строка 11: | Строка 11: | ||
<general></general> | <general></general> | ||
</task> | </task> | ||
| + | <contact> | ||
| + | <general></general> | ||
| + | </contact> | ||
<taskNewStatus></taskNewStatus> | <taskNewStatus></taskNewStatus> | ||
<notifiedList> | <notifiedList> | ||
| Строка 63: | Строка 66: | ||
|description ||string ||текст с описанием действия, комментарий || | |description ||string ||текст с описанием действия, комментарий || | ||
|- | |- | ||
| − | |task || ||задача, в | + | |task | contact || ||задача/контакт, в которого добавляется действие - должен присутствовать только один узел (или task или contact) || |
|- | |- | ||
|task.id ||int ||идентификатор задачи, информацию которой хотим получить || | |task.id ||int ||идентификатор задачи, информацию которой хотим получить || | ||
|- | |- | ||
|task.general||int ||номер задачи (если задан, используется вместо id)|| | |task.general||int ||номер задачи (если задан, используется вместо id)|| | ||
| + | |- | ||
| + | |contact.general||int ||номер контакта || | ||
|- | |- | ||
|taskNewStatus ||enum ||этим действием меняется статус задачи на указанный ||не обязательный параметр, перечень допустимых значений смотри в разделе [[ПланФикс API:Статусы задач|статусы задач]] | |taskNewStatus ||enum ||этим действием меняется статус задачи на указанный ||не обязательный параметр, перечень допустимых значений смотри в разделе [[ПланФикс API:Статусы задач|статусы задач]] | ||
Версия 14:34, 24 февраля 2017
Добавление действия. Неполная версия функции, будет дорабатываться:
<?xml version="1.0" encoding="UTF-8"?>
<request method="action.add">
<account></account>
<sid></sid>
<action>
<description></description>
<task>
<id></id>
<general></general>
</task>
<contact>
<general></general>
</contact>
<taskNewStatus></taskNewStatus>
<notifiedList>
<user>
<id></id>
<id></id>
<!-- ... -->
</user>
</notifiedList>
<isHidden></isHidden>
<owner>
<id></id>
</owner>
<analitics>
<analitic>
<id></id>
<analiticData>
<itemData>
<fieldId></fieldId>
<value></value>
</itemData>
<itemData>
<fieldId></fieldId>
<value></value>
</itemData>
<!-- ... -->
</analiticData>
</analitic>
<analitic>
<id></id>
<analiticData>
<itemData>
<fieldId></fieldId>
<value></value>
</itemData>
<itemData>
<fieldId></fieldId>
<value></value>
</itemData>
<!-- ... -->
</analiticData>
</analitic>
<!-- ... -->
</analitics>
</action>
<signature></signature>
</request>| Название | Тип | Значение | Примечание |
|---|---|---|---|
| description | string | текст с описанием действия, комментарий | |
| contact | задача/контакт, в которого добавляется действие - должен присутствовать только один узел (или task или contact) | ||
| task.id | int | идентификатор задачи, информацию которой хотим получить | |
| task.general | int | номер задачи (если задан, используется вместо id) | |
| contact.general | int | номер контакта | |
| taskNewStatus | enum | этим действием меняется статус задачи на указанный | не обязательный параметр, перечень допустимых значений смотри в разделе статусы задач |
| notifiedList | этим действием необходимо уведомить следующих пользователей | необязательный параметрполе | |
| notifiedList.user | список пользователей которые получат уведомление | ||
| notifiedList.user.id | int | идентификатор пользователя | |
| isHidden | bool | является ли действие(комментарий) скрытым от всех пользователей, за исключением списка уведомленных пользователей | не обязательное поле, по умолчанию равно 0 (false) |
| owner | автор действия | необязательное поле. Если не указано - берется пользователь от имени которого выполняется функция | |
| owner.id | int | идентификатор автора действия | |
| analitics | задается (прикрепляется) список аналитики | не обязательный параметр | |
| analitics.analitic | узел, содержащий данные по прикрепляемой аналитике | ||
| analitic.id | int | идентификатор аналитики | список доступных аналитик можно получить при помощи функции analitic.getList |
| analitic.analiticData | список значений полей | ||
| analiticData.itemData | значение одного из параметров | ||
| itemData.fieldId | int | идентификатор параметра | идентификатор параметра равен field.id |
| itemData.value | string | значение | |
| формат значения для разных типов аналитики: | |||
| DATE | дд-мм-гггг | ||
| TIME | чч:мм | ||
| TIMEPERIOD | <begin>чч:мм</begin><end>чч:мм</end> | ||
| HANDBOOK | int - key записи справочника | ||
| USER | int - идентификатор сотрудника | ||
| CLIENT | int - идентификатор контрагента | ||
| LOGINLIST | <id></id>...<id></id> - где каждый из узлов (узел может быть один) содержит идентификатор сотрудника, к которому относится аналитика. | ||
Результат удачного выполнения запроса:
<?xml version="1.0" encoding="UTF-8"?>
<response status="ok">
<action>
<id></id>
</action>
</response>| Название | Тип | Значение | Примечание |
|---|---|---|---|
| action.id | int | идентификатор добавленного действия |
В противном случае будет возвращен ответ с ошибкой:
<?xml version="1.0" encoding="UTF-8"?>
<response status="error">
<code></code>
</response>