ПланФикс API analitic.getData: различия между версиями

Материал из Planfix
Перейти к: навигация, поиск
(Новая страница: «Получение данных аналитики прикрепленной действием. Список доступных аналитик получают ...»)
 
Нет описания правки
 
(не показано 5 промежуточных версий этого же участника)
Строка 18: Строка 18:
|sid || string(32) ||ключ сесии || выдается в результате прохождения [[ПланФикс API:Аутентификация|аутентификации]]  
|sid || string(32) ||ключ сесии || выдается в результате прохождения [[ПланФикс API:Аутентификация|аутентификации]]  
|-
|-
|analitic.id|| int || идентификатор аналитики ||
|analiticKeys.key|| int || идентификатор строки данных аналитики || возвращается функцией [[ПланФикс API action.get|action.get]]
|-
|-
|}
|}
Допускается одним запросом получать данные сразу нескольких добавленных аналитик. Если в запросе был передан идентификатор несуществующей аналитики, то будет возвращена пустая аналитика, ошибка при этом не будет генерироваться.
Ответ при успешном выполнении запроса:
<source lang="xml">
<?xml version="1.0" encoding="UTF-8"?>
<response status="ok">
  <analiticDatas>
    <analiticData>
      <key></key>
      <itemData>
        <id></id>
        <name></name>
        <value></value>
        <valueId></valueId>
      </itemData>
      <itemData>
        <id></id>
        <name></name>
        <value></value>
        <valueId></valueId>
      </itemData>
      <!-- ... -->
    </analiticData>
    <analiticData>
      <key></key>
      <itemData>
        <id></id>
        <name></name>
        <value></value>
        <valueId></valueId>
      </itemData>
      <itemData>
        <id></id>
        <name></name>
        <value></value>
        <valueId></valueId>
      </itemData>
      <!-- ... -->
    </analiticData>
    <!-- ... -->
  </analiticDatas>
</response>
</source>
{| class="wikitable" style="margin-top: 1em; width:100% "
!width="150"|Название !!width="200"| Тип !!width="50%"| Значение !! Примечание
|-
|analiticDatas  ||  || список запрошенных аналитик  ||
|-
|analiticData  ||  || узел описывающий данные, которые содержит аналитика ||
|-
|analiticData.key  || int || идентификатор данных ||
|-
|analiticData.itemData  ||  || узел описывающие запись с данными в аналитике ||
|-
|itemData.id  || int  || идентификатор, он равен [[ПланФикс API analitic.getOptions|field.id]] ||
|-
|itemData.name  || string || имя поля  ||
|-
|itemData.value  || string || значение (строковое представления)  ||
|-
|itemData.valueId  || string || значение (идентификатор для полей, содержащих объект) ||
|-
|}
В противном случае будет возвращен ответ с ошибкой:
<source lang="xml">
<?xml version="1.0" encoding="UTF-8"?>
<response status="error">
  <code></code>
</response>
</source>
== Перейти ==
*[[ПланФикс API:Аналитика]]
*[[Коды ошибок]]
*[[Список функций]]

Текущая версия от 13:35, 9 июня 2020

Получение данных аналитики прикрепленной действием. Список доступных аналитик получают из списка действий. Формат запроса:

<?xml version="1.0" encoding="UTF-8"?>
<request method="analitic.getData">
  <account></account>
  <sid></sid>
  <analiticKeys>
    <key></key>
    <key></key>
    <!-- ... -->
  </analiticKeys>
  <signature></signature>
</request>
Название Тип Значение Примечание
sid string(32) ключ сесии выдается в результате прохождения аутентификации
analiticKeys.key int идентификатор строки данных аналитики возвращается функцией action.get

Допускается одним запросом получать данные сразу нескольких добавленных аналитик. Если в запросе был передан идентификатор несуществующей аналитики, то будет возвращена пустая аналитика, ошибка при этом не будет генерироваться.

Ответ при успешном выполнении запроса:

<?xml version="1.0" encoding="UTF-8"?>
<response status="ok">
  <analiticDatas>
    <analiticData>
      <key></key>
      <itemData>
        <id></id>
        <name></name>
        <value></value>
        <valueId></valueId>
      </itemData>
      <itemData>
        <id></id>
        <name></name>
        <value></value>
        <valueId></valueId>
      </itemData>
      <!-- ... -->
    </analiticData>
    <analiticData>
      <key></key>
      <itemData>
        <id></id>
        <name></name>
        <value></value>
        <valueId></valueId>
      </itemData>
      <itemData>
        <id></id>
        <name></name>
        <value></value>
        <valueId></valueId>
      </itemData>
      <!-- ... -->
    </analiticData>
    <!-- ... -->
  </analiticDatas>
</response>
Название Тип Значение Примечание
analiticDatas список запрошенных аналитик
analiticData узел описывающий данные, которые содержит аналитика
analiticData.key int идентификатор данных
analiticData.itemData узел описывающие запись с данными в аналитике
itemData.id int идентификатор, он равен field.id
itemData.name string имя поля
itemData.value string значение (строковое представления)
itemData.valueId string значение (идентификатор для полей, содержащих объект)


В противном случае будет возвращен ответ с ошибкой:

<?xml version="1.0" encoding="UTF-8"?>
<response status="error">
  <code></code>
</response>


Перейти