ПланФикс API analitic.getHandbook
Материал из Planfix
								
												
				Получение справочника для аналитики. Формат запроса:
<?xml version="1.0" encoding="UTF-8"?>
<request method="analitic.getHandbook">
  <account></account>
  <sid></sid>
  <handbook>
    <id></id>
  </handbook>
  <signature></signature>
</request>| Название | Тип | Значение | Примечание | 
|---|---|---|---|
| sid | string(32) | ключ сесии | выдается в результате прохождения аутентификации | 
| handbook.id | int | идентификатор справочника | получается в результате выполнения функции получить описание аналитики | 
Ответ при успешном выполнении запроса:
<response status="ok">
  <records>
    <record>
      <key></key>
      <parentKey></parentKey>
      <isGroup></isGroup>
      <value value="" name="" isDisplayed="" />
      <value value="" name="" isDisplayed="" />
      <!-- ... -->
    </record>
    <record>
      <key></key>
      <parentKey></parentKey>
      <isGroup></isGroup>
      <value value="" name="" isDisplayed="" />
      <value value="" name="" isDisplayed="" />
      <!-- ... -->
    </record>
    <!-- ... -->
  </records>
</response>| Название | Тип | Значение | Примечание | 
|---|---|---|---|
| records | список записей в справочнике | ||
| record | узел описывающий запись в справочнике | ||
| record.key | int | идентификатор записи | |
| record.parentKey | int | идентификатор родительской записи | |
| record.isGroup | bool | является ли узел родителем/названием группы | записи данного типа не могут использоваться для аналитике, используются для группировки данных | 
| record.value | узел описывающий данные в записи | ||
| value value | string | значение поля | |
| value name | string | имя | |
| value isDisplayed | bool | отображаемое поле или нет | 
В противном случае будет возвращен ответ с ошибкой:
<?xml version="1.0" encoding="UTF-8"?>
<response status="error">
  <code></code>
</response>