Просмотр исходного текста страницы ПланФикс API action.add

Добавление действия.  Неполная версия функции, будет дорабатываться:
<source lang="xml">
<?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>
</source>
{| class="wikitable" style="margin-top: 1em; width:100% "
!width="150"|Название !!width="200"| Тип !!width="50%"| Значение !! Примечание 
|-
|description ||string ||текст с описанием действия, комментарий ||
|-
|task | contact || ||задача/контакт, в которого добавляется действие - должен присутствовать только один узел (или task или contact) ||
|-
|task.id ||int ||идентификатор задачи, информацию которой хотим получить ||
|-
|task.general||int ||номер задачи (если задан, используется вместо id)||
|-
|contact.general||int ||номер контакта ||
|-
|taskNewStatus  ||enum ||этим действием меняется статус задачи на указанный ||не обязательный параметр, перечень допустимых значений смотри в разделе [[ПланФикс API:Статусы задач|статусы задач]]
|-
|notifiedList || ||этим действием необходимо уведомить следующих пользователей ||необязательный параметрполе
|-
|notifiedList.user || || список пользователей которые получат уведомление ||
|-
|notifiedList.user.id ||int || идентификатор пользователя ||
|-
|isHidden ||bool || является ли действие(комментарий) скрытым от всех пользователей, за исключением списка уведомленных пользователей || не обязательное поле, по умолчанию равно 0 (false)
|-
|owner || || автор действия||необязательное поле. Если не указано - берется пользователь от имени которого выполняется функция
|-
|owner.id ||int ||идентификатор автора действия ||
|-
|analitics  ||  || задается (прикрепляется) список аналитики  || не обязательный параметр
|-
|analitics.analitic  ||  || узел, содержащий данные по прикрепляемой аналитике ||
|-
|analitic.id  || int  || идентификатор аналитики || список доступных аналитик можно получить при помощи функции [[ПланФикс API analitic.getList|analitic.getList]]
|-
|analitic.analiticData  ||  || список значений полей  ||
|-
|analiticData.itemData  ||  || значение одного из параметров ||
|-
|itemData.fieldId  || int  || идентификатор параметра || идентификатор параметра равен [[ПланФикс API analitic.getOptions|field.id]]
|-
|itemData.value  || string || значение ||
|-
| ||colspan="3" | формат значения для разных типов аналитики:
|-
| || DATE || colspan="2"| дд-мм-гггг
|-
| || TIME || colspan="2"| чч:мм
|-
| || TIMEPERIOD || colspan="2"| <begin>чч:мм</begin><end>чч:мм</end>
|-
| || HANDBOOK || colspan="2"| int - key записи справочника
|-
| || USER || colspan="2"| int - идентификатор сотрудника
|-
| || CLIENT || colspan="2"| int - идентификатор контрагента
|-
| || LOGINLIST || colspan="2"| <id></id>...<id></id> - где каждый из узлов (узел может быть один) содержит идентификатор сотрудника, к которому относится аналитика.
|-
|}


Результат удачного выполнения запроса:
<source lang="xml">
<?xml version="1.0" encoding="UTF-8"?>
<response status="ok">
  <action>
    <id></id>
  </action>
</response>
</source>
{| class="wikitable" style="margin-top: 1em; width:100% "
!width="150"|Название !!width="200"| Тип !!width="50%"| Значение !! Примечание 
|-
|action.id ||int ||идентификатор добавленного действия ||
|-
|}

В противном случае будет возвращен ответ с ошибкой:
<source lang="xml">
<?xml version="1.0" encoding="UTF-8"?>
<response status="error">
  <code></code>
</response>
</source>



== Перейти ==
*[[ПланФикс API:Действия]]
*[[Коды ошибок]]
*[[Список функций]]